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Notations 


Throughout this manual we have tried to follow the following conventions in notation: 


BOLD face letters are used for vectors and matrices in formulas, with vectors in lower 
case and matrices in upper case. The transpose of a matrix M is denoted as M' and its 
inverse as M1. 


For the description of commands, bold face denotes keywords which should be typed 
as shown. Uppercase and lowercase should not matter, they are only used to 
distinguish between command keywords and options in the manual. When in doubt, 
use uppercase. 


Italic is used for parameters which should be replaced with actual values. 
Emphasized text is also typed in italic. 


Courier font is used for examples and for file names. 
Parentheses '( )' or question marks '?' enclose optional parts in command descriptions. 
In addition, lists which show a number of choices are enclosed in parentheses with a 


vertical bar '|' as the delimiter. (Yes, this is somewhat ambiguous.) 


Brackets '[ |' denote default values. 
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Corrections & Improvements 


A number of major corrections, bug-fixes and improvements have been made since 
the last official release of XD (Rev 14, 1999) 


The exponents of 3d and 4s orbitals were interchanged by XDPROP when 
computing a default single-zeta exponent for the multipoles (option CSZD for 
DEFV in the SCAT Table). This error could cause severe problems in the topology, 
but it was quite easily detectable by a simple *check option in the output of 
XDPROP 

The same occured for ns and (n-1)s/p for some closed-shell cations. 

The default radial exponent for fourth-row atoms was n = 4 instead of m = 6 (in 
both XDLSM and XDPROP) 

The configuration of the SCAT table was not read by XDPROP and the default 
configuration (stored in the databank) was always applied. 

When computing the radial function for multipoles with an orbitalic product 
(option CHFW for DEFV), the normalisation of the spherical harmonics was 
applied two times in XDPROP. This error was producing underestimated 
deformations around the atom. Because it was mainly adopted for describing 3d 
orbitals of transition metals, its effect was to reduce the polarisation of the inner 
valence shell, without affecting too seriously the density in the region of the 
bonding and the overall topology. Again, only the default valence orbitals were 
used, despite any different request by the user. 

The option GROUP atoms was not applied when computing the electrostatic 
potential (esp). 

Molecular quadrupole moments had an incorrect unit transformation. 

Molecular Dipole and Quadrupole calculations did not support the CHFW option 
for radial functions. 

TOPXD is now directly interfaced to XD. 

The anisotropic extinction refinement has been corrected (and a bug concerning 
interpretation of the wavelength has been removed - see Section 4.6.8 for more 
details) 

Symmetry operations 6; and 6s were not properly supported. 

U factors for H atoms were erroneously transformed by XDINI from SHELX input if 
restraints were present. 

In the presence of atoms in special positions, XDPROP had some problems in 
correctly reproducing all the atoms requested by users through the APPLY symm 
option. 


Updates 


Further updates will be issued from time to time by the XD programming team. These 
will be placed on the XD web-sites given above. See these sites for news of the latest 
bug-fixes and modifications to XD. 
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Chapter 1 


Introduction 


1.1 Synopsis for non-crystallographers 


Chemical crystallography and quantum chemistry encompass our knowledge about the 
detailed structure of molecules, their properties and reactions, and the distribution of 
electronic charge in their atoms and chemical bonds. On this insight are based all modern 
theories of chemical reactivity, and the design principles for new materials and drugs. Great 
advances in the last two decades have led to the present theoretical and experimental 
methods for determining molecular structure at the electronic level; we can in principle (and 
increasingly in practice) obtain not just the positions of atoms in molecules but all other 
topological properties of the associated electron distribution (ED). 


A beam of X-rays is diffracted by the electrons in a crystalline material, just as visible light is 
diffracted by larger objects. Recombination of diffracted light by means of lenses can give a 
magnified image of the object; X-rays, having a wavelength about four orders of magnitude 
shorter than that of visible light, produce an image of the electron or charge density 
distribution characteristic of the diffracting crystal. There exist no lenses as such for X-rays, 
but recombination of diffracted rays into an image can be brought about by suitable detection 
followed by computational Fourier transformation. The experiment is effectively an X-ray 


microscope for the disposition of electronic charge. 


In practice we can bypass the Fourier transformation, because quantum mechanics enables 
us to construct a mathematical model of the charge density in a crystal. The parameters of 
such a model can be adjusted to reproduce the experimentally-measured pattern of diffracted 
X-rays, given prior knowledge of the arrangement of atomic nuclei in the crystal lattice. For 
chemical (as distinct from biological) molecules this can usually be found routinely using the 
methods of conventional crystal structure analysis programmed in widely available computer 
packages. This leads to a 'ball and stick' model of the atoms and bonds representing the 
topology of the charge density at the level of its most salient features, found at the positions of 
the atomic nuclei. It is obtained by Fourier transformation of the diffracted X-ray pattern at 
relatively low resolution. Next we can proceed with a far more elaborate, so-called 'multipole' 
model of the crystalline density, fitting it to a diffraction experiment carried out at high 


resolution, such that two points as close together as 0.4xX10-!° m can be distinguished. As 
mentioned earlier, we need no Fourier transformation at this stage because the charge density 
in fine detail can be computed directly from the fitted multipole model. One major component 
of the XD package is the program for least squares (lsq) fitting of a multipole model to the 
experimental data. 


Once a charge distribution has been obtained experimentally, various chemical and physical 
properties that depend on the distribution can be derived. The chemical structure of 
molecules can be extracted from an analysis of the topology of the charge distribution, the 
features of which are summarized by the curvatures of the charge density at its critical points. 
Each feature, maximum, minimum or saddle has associated with it a point in space called a 
critical point, where the density is flat. One type of critical point has all three curvatures in 3-D 
space negative; it is found at the sites of atomic nuclei. Other types, with both positive and 
negative curvatures, are associated with bonding interactions between atoms. Because the 
strength and nature of the interactions are characterized by topology, the chemistry of the 
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molecule can be recovered as a property of its charge distribution. A program for deriving 
molecular properties from the multipole model of the charge distribution is thus another 
major component of XD. Many of these properties can be displayed pictorially, using the 2-D 
and 3-D graphics programs which plot contour, relief and iso- surface maps of selected 
properties such as deformation density, Laplacian of the total density, electrostatic potential 
etc. 


1.2 Experimental electron densities 


X-ray diffraction was first applied with the purpose only of determining the positions of atoms 
in crystals and hence the geometrical structure of crystals and molecules. With the 
development of single-crystal diffractometers and computing facilities from the middle 1960s 
onwards came studies aimed at obtaining an experimental description of the chemical 
bonding to compare with the picture given by quantum chemistry theoretical calculations 
[1,2,3,4]. Accurate experimental measurement of the charge density in a crystal has been 
feasible since that time, following the development of sufficiently compact parameterized 
descriptions of molecular densities [5,6]. One of the most exciting applications of such an 
analysis is the evaluation of one-electron properties in molecular crystals. In a pioneering 
paper [7] Coppens et al. demonstrated the feasibility of this technique for a number of 
centrosymmetric crystals. However, applications to non-centrosymmetric materials, such as 
organic materials with non-linear optical applications, have been relatively few. In part, this is 
certainly due to the increased difficulty of obtaining accurate model structure factors when 
the phase is a continuous variable. Nevertheless, recent applications have demonstrated the 
usefulness and potential accuracy of the technique in the non-centrosymmetric case [8,9]. 


ED determinations [10] are based on intensity measurements of X-ray photons elastically 
scattered by crystals. In the next section a brief summary is given on some theoretical aspects 
of the procedure to extract the ED from X-ray diffraction data. For more detailed descriptions 
the reader is referred to references [11,12]. 


1.3 Theoretical aspects of electron density determination 


According to the kinematical theory of scattering [13] the total diffraction intensity is 
2 
Lg -)r e (| F(h.q)| )r (Eq.1-1) 


where F(h,q) is the Fourier transform of p (r,q), the static ED at a given nuclear configuration 
q, h is the Bragg vector with integral components hj, ho, ha relative to the 


F(h.q) = |, p(r. a) exprhr)ar (Eq. 1-2) 


reciprocal axes a*, b*, c*, V is the unit-cell volume and ( )r means thermal averaging over all 
vibrational states. By disregarding the diffuse scattering altogether 


5 E T aus =| (F(h.q); li (Eq. 1-3) 


it is assumed that the averaged scattering from a dynamic system can be well approximated 
by its main component, the scattering from the average structure [14,15]. This expression 
relates the intensity to the ED and its derivation implicitly includes assumptions directly not 
deducible from the experiment; assumptions on the coupling between nuclear and electronic 
motion and on the partitioning of the molecular ED into atomic components (convolution 
approximation). Based on this equation the ED in the crystal can be given by a Fourier 
summation 
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p(r) 2 V $F, exp(—2nhr) (Eq. 1-4) 
h 


This direct evaluation of p to a desired level of resolution, is subject to severe limitations: (i) 
the observed structure factors are affected by experimental errors, (ii) the phases are not 
measured, (iii) only a finite number of reflections can be collected. Due to these limitations the 
interpretation of the X-ray data necessarily involves modelling the ED and optimizing its 
parameters by adjusting the calculated structure factors to those measured. 


1.4 Electron density - Structure factor models 


Within the convolution approximations the dynamic ED is 


(p(r)), = > pr-d —u, )P(u, )du, (Eq. 1-5) 


where the summation runs over the density units p centered at qxo and Px(ux is the 
probability distribution function (pdf) describing the displacement ux of the k-th center with 


respect to its equilibrium position. The structure factor is then the Fourier transform of (p(r) 


)r 
F(h) = Y f, (yr, (b) exp(27thq,, ) (Eq. 1-6) 


where fx is the static scattering power of the k-th density unit and tx is the associated 
temperature factor. The commonly used scattering models differ in the description of fx and tx, 
both of which are, in general, complex functions of static and dynamic parameters, 
respectively. 


1.5 Conventional formalism 


This generalized form (1.6) is reduced to the conventional model if p; is taken as the spherical 
atomic density and the nuclear motion is described within the harmonic approximation. This 
formalism disregards static deformations due to the chemical bonding and the least squares 
estimates of the corresponding parameters are likely to be biased. Such errors ('asphericity' 
shifts) usually manifest themselves in significantly shorter bond distances and smaller bond 
angles (at atoms with lone-pair electrons) relative to the values obtained by neutron 
diffraction. The accuracy of the thermal parameters is even more doubtful as the anisotropic 
displacements can 'absorb' charge deformation. To overcome the inadequacy of the isolated 
atom model several methods can be applied. 


1.6 High order refinement 


In the atomic regions where the electron density is less affected by the bonding the isolated 
atom model is expected to be a fair approximation. The sharp core density has appreciable 
contribution to reflections at high Bragg angle where the scattering by the more diffuse 
valence or bond density is negligible. For this reason a refinement emphasizing the high-order 
data is expected to yield atomic parameters less biased by the inadequacy of the spherical- 
atom model [16]. 
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1.7 The aspherical-atom formalism 


The accuracy of the parameters can significantly be increased by implementing aspherical 
density models into the fit of all measured data. To account for the density deformations due 
to chemical bonding several methods have been developed and applied [17,18]. One of the 
most successful refinement techniques is based on the nucleus-centered finite multipole 
expansion of the ED[6]. The formalism refined by Hansen & Coppens [19] is implemented in 
XD. The aspherical atomic ED is divided into three components: 


p(r)=p.(7)+ P,p, (kr) + p, (kr) (Eq. 1-7) 


where p, and p, are the core and spherical valence densities (sphv), respectively and is 


r 


l 
KD - YR (c) V P, Yn C) (Eq. 1-8) 
l 


m--l 


the term accounting for valence deformations. The ym are density normalized, real spherical 
harmonics, such that: 


2n pn 
Labs |42.= 2,120 (Eq. 1-9) 


=1,/=0 (Eq. 1-10) 


while R; are properly chosen radial functions, and an element of solid angle dQ. = sin@d@do . 


The isolated-atom valence density and the radial functions Ri are modified by the screening 


constants (K and K', respectively) to account for the radial expansion or contraction of the 
valence shell. The corresponding scattering factor is 


fw - canes (5) EE) Erre) (Eq. 1-11) 


K m=-l 


where (Ji) is the lth order Fourier-Bessel transform of Rr 


(Jj) = 4ni' | j, 2nHr)R,(r)r7dr (Eq. 1-12) 


with ji being the l-th order spherical Bessel function. Closed-form expressions for evaluating 
(Ji) using different types of radial functions have been given in reference [18]. 


1.8 Orbital vs. Multipole formalism 


For a single-Slater determinant atomic wavefunction composed of orthogonal spin-orbitals the 
electron density is given by 


p-2nlef (Eq. 1-13) 


where niis the orbital occupation number (1 or 2) of the ith atomic orbital, 


$; = Prim = Ray, (Eq. ls 14) 
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If the radial part Ru is expanded in terms of basis functions 


Roy 040, (Eq. 1-15) 
J 
the density unit p,j; corresponding to yim is given by the following linear combination: 


Prim E 55.09, po = Rome (Eq. 1-1 6) 
jk 


The spherical harmonics form a complete basis set, thus their product can be expanded over 
spherical harmonics: 


Jim Vim = > C rirumn'yLM (Eq. 1- 17) 
LM 


The Clebsch-Gordon coefficients (Curwmm) are given for both complex and real spherical 
harmonics (up to L[-2) in the literature [12]. It follows that the orbital product representation 
of the atomic density is completely equivalent to the multipolar description. This equivalence 
does not hold for molecules because of the two-center orbital products occurring in expression 
(1.13). 


1.9 Radial functions and scattering factors 


The core and spherical valence density are calculated from  Hartree-Fock atomic 
wavefunctions [20] expanded in terms of Slater-type basis functions: 


O, -[Qn(D)'] ^ Q5,) 79? expr) (Eq. 1-18) 


where zi are energy optimized orbital exponents. 


The radial functions of the deformation density are also taken as simple Slater functions: 
r"? exp(-a,r) (Eq. 1-19) 


with n(lJ21 to obey Poisson's equation [21] and with values for a; as deduced from the single-G 
wavefunctions. As shown above, the evaluation of the scattering factor of an orbital product 
requires the calculation of Lth-order Fourier Bessel transforms of OO: ((jpu). The simple 
scheme below shows how Lis related to land I ([20,1,2 for s,p and d, respectively): 


[NI S p d 
S 0 1 2 
p 02 13 
d 024 


Taking the carbon atom as an example, the following scattering factors can be generated from 
the wavefunction: 


core: (jo)(1s1s) 
sphv: (jo)(2s2s) + (jo(2p2p) 
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Dipolar (1) and quadrupolar ([=2) radial scattering functions included in the deformation 
term in (1.8) could be composed as the Fourier-Bessel transforms of sp and pp type orbital 
products: 


defv: (j)(2s2p), (j2)(2p2p) 


1.10 The temperature factor 


In harmonic approximation the vibrational pdf of the nuclear displacement vector u, taken 
with respect to the equilibrium position (u = q-q.), is a normal distribution: 


P (u) = (2x) ^" (detU) "^ exp(-1/2u'U 'u) (Eq. 1-20) 


where U is the mean-square displacement amplitude (MSDA) matrix. 


The corresponding atomic anisotropic temperature factor is the Fourier transform of P.(u): 
t, (h) = exp(-2x ^h'Uh) (Eq. 1-21) 


Anharmonic models in practical use are based on statistical approaches. If the anharmonicity 
is small the corresponding pdf can be expanded about the normal distribution. In the Gram- 
Charlier expansion [22] implemented in XDLSM the anharmonic pdf is approximated in terms 
of zero and higher derivatives of the normal distribution: 


A, +...)P 


1 1 
P(u)- TE iH y US 2 (Eq. 1-22) 


Jklm^ ^ jklm 
where Hir- are three dimensional Hermite polynomials being functions of U and u, while the 
coefficients Cjr- are the quasi-moments being related to the moments of the pdf. The 
advantage of this form is that its Fourier transform is reduced to a simple power series 
expansion about the harmonic temperature factor: 


TH) - 0. - 5C yh hh, + on °C hh, hh, +...)T,(H) | (Eq. 1-23) 


jklm ^* j 


1.11 Deformation electron density 


The conventional model is based on the pro-molecular density which is the superposition of 
the spherical atomic densities px(r) centered at the actual nuclear positions in the molecule. 
The promolecule can serve as a reference state relative to which charge migrations due to 
bond formations are expected to become visible [23]. 


óp(r) = P mol (r) x >a Px (r ~ r,) (Eq. 1-24) 
k 


To interpret the óp(r) one always has to critically examine not only the method yielding the 
molecular electron density but the effect of the preconceptions applied in composing the 
promolecule. For atoms with a degenerate ground state, px is obtained by sharing the valence 
electrons among orbitals of different angular dependence regardless of their 'ability' to form a 
bond in the actual arrangement of the atoms. As a result the obtained deformation electron 
density may not show the expected features of the covalent bond or lone-pair density [24]. 
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In order to obtain a chemically meaningful deformation electron density, an alternative 
promolecule has bee proposed for wich the configuration and the orientation of the ground 
state of each constituent atom is correctly specified by a fitting procedure [25]. To elucidate 
important aspects of delocalization, effects of substitution or intermolecular interactions one 
can consider fragments or molecules to choose as the basis for comparison [26,27]. Atoms 
prepared for bond formation can also serve as references [28]. 


If the deformation electron density is evaluated by a Fourier summation 


dp(r) = Y [F, (h) - F, (h)]expC-2xihr) (Eq. 1-25) 


the series termination error is considerably decreased. The phases and the Fe are usually 
calculated from the promolecule with atomic and positional parameters obtained from (i) 
neutron diffraction data (X-N) [29], (ii) conventional refinement on high-order X-ray data (X- 
Xn»), (iii) full-data aspherical-atom refinement (X-X mui). 


1.12 Experimental requirements 


The applicability of the above formalism depends on the compound to be studied and its 
crystalline form, the radiation used and the method of the data collection. The kinematic 
theory is valid only in a certain frequency range: p, > n» uy, where ug corresponds to the K 
absorption edge of any atom in the molecule and u, is the frequency limit, where relativistic 
effects occur. Accordingly, atoms with high atomic number (Z>18) are not well suited for 
charge density studies when a standard X-ray source is used. Bonding effects are likely to be 
invisible for atoms with small valence to core electron ratio [30]. 


The most important requirement for an accurate measurement is to maintain kinematical 
conditions or to make the systematic errors, due to dynamic scattering, correctable. To reveal 
these effects equivalent reflections should be measured. To minimize the diffuse scattering 
the data should be collected at low temperature. Details of the data reduction can be found in 
references [31,32,33,34]. 


1.13 Determination of atomic and structural properties from 
charge distributions 


1.13.1 Critical points of the charge density 


Once a charge distribution has been obtained experimentally, various chemical and physical 
properties that depend on the distribution can be derived. Bader [35] shows how the chemical 
structure of molecules can be extracted from an analysis of the topology of p(r), the features of 
which are summarized by the curvatures of p(r) at its critical points. Each feature, maximum, 
minimum or saddle has associated with it a point in space called a critical point, where the 
first derivatives of p(r) vanish. At such a point, denoted by position vector r., 


voee ea eh 
Ox ` Oy Oz 


where i, j, k are unit vectors. Whether a function is a maximum or minimum is determined 
by the sign of its second derivative, or curvature, at the stationary point. In general, for an 
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arbitrary choice of coordinate axes, there will be nine second derivatives of the form 6’p/dxdy in 
the determination of the curvatures of p at a point in space. Their ordered 3x3 array, the 
Hessian matrix of the charge density, can be diagonalized to yield the principal axes of 
curvature, with respect to which the magnitudes of the three second derivatives of p are 
extremized. The principal axes and their corresponding curvatures at a critical point in p are 
obtained as the eigenvectors and corresponding eigenvalues (A) of the Hessian matrix of p(r). 
The rank c of a critical point is the number of non-zero eigenvalues or curvatures of p at the 
critical point, while its signature o is the algebraic sum of the signs of the curvatures at that 
point. The critical point is labelled by giving the pair of values (w,0). With few exceptions the 
critical points of charge distributions for stable molecules are of rank three, and there are four 
possible signature values and labels: 


(3,-3) all curvatures are negative and p is a local maximum at re. 

(3,-1) two curvatures are negative and pis a maximum at r- in the plane defined by 
their corresponding axes. p is a minimum at rc along the third axis, 
perpendicular to this plane. 

(3,+1) two curvatures are positive and p is a minimum at rc in the plane defined by 
their corresponding axes. p is a maximum at rc along the third axis, 
perpendicular to this plane. 

(3,+3) all curvatures are positive and p is a local minimum at re. 


The traditional association of nuclear positions with local maxima in p(r) can now be 
formalized as the statement that nuclear positions behave topologically as (3,-3) critical points 
in the charge distribution. 


1.13.2 Interatomic surfaces and chemical bonds 


A useful function is obtained in the form of the gradient vector field of the charge density, 
represented through a display of the trajectories traced out by the vector Vp. The gradient 
vector points in the direction of the greatest increase in p, so these trajectories are 
perpendicular to the contour lines of p. They have the property of originating or terminating at 
critical points in p. The charge distribution is partitioned into disjoint regions by surfaces for 
which 


Vp(r):n(r) =0 


where n is the vector normal to the surface. These so-called zero flux surfaces are the 
interatomic surfaces or quantum mechanical boundaries of the atoms, and contain (3,-1) 
critical points when the atoms are chemically bonded. The pairs of gradient paths which 
originate at each (3,-1) critical point and terminate at the nuclei define a line through the 
charge distribution linking the neighbouring nuclei, along which p(r) is a maximum with 
respect to any neighbouring line. This line is called a bond path and the (3,-1) critical point is 
referred to as a bond critical point. This is the topological definition of a chemical bond, 
formalizing the theoretically predicted and experimentally observed accumulation of charge 
between bonded nuclei. Chemical structure can thus be recovered as a property of the charge 
distribution. The strength and nature of the chemical bond can be characterized by the value 
of various properties evaluated at the bond critical points, e.g. bond order, bond ellipticity, 
p(r3, V?p(r9 [22]. 


The value of pc in a bond measures its strength [36]; the trace of the Hessian at re measures 
the extent of depletion or concentration of charge; and the ratio of eigenvalues of this matrix 
(the bond ‘ellipticity’ € ) measures the degree of planarity or conjugation. More precisely, 
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€=(A2/A1)-1, where the X's are the two eigenvalues of the Hessian corresponding to directions 
perpendicular to the bond. 


Stationary points in p have been applied in characterizing benzenoid aromaticity [37], 
homoaromaticity and hyperconjugativity [38,39,40], and electrophilic substitution [41,42]. A 
number of applications of the topological properties of experimental charge distributions 
obtained from neutron and X-ray diffraction data for organic molecular crystals have been 
reported [43,44,45,46]. 


1.13.3 Lewis electron pairs - the Laplacian 


The trace of the Hessian matrix, the quantity 

0p Op 0p 
= + + 

Ox? Oy? o7 
is termed the Laplacian of p and has physical meaning as representing local concentrations, 
where V’p(r) < 0, and depletions, where V’p(r) > O, of the charge density. Electronic charge is 
compressed above its average distribution in regions where the Laplacian is negative, and 
expanded relative to its average distribution where the Laplacian is positive. Maxima and 
minima in the function V’p(r) are to be distinguished from local maxima and minima in the 
charge density itself. Although the topology of p yields a faithful mapping of the chemical 
concepts of atoms, bonds and structure, there is no indication of maxima inp corresponding 
to the localized electron pairs of the Lewis model of electronic structure, of great importance to 
our interpretation of chemical reactivity and molecular geometry. The physical basis of this 
model is one level of abstraction above the visible topology of the charge density and appears 
instead in the topology of the Laplacian of p, the scalar derivative of the gradient vector field of 
the charge density. 


V^p(r) 


The Laplacian distribution recovers the electronic shell model of an atom by exhibiting a 
corresponding number of pairs of shells of charge concentration and charge depletion. For a 
spherical free atom, the outer or valence shell of charge concentration (VSCC) contains a 
sphere of uniform concentration of electronic charge. Upon entering into chemical 
combination, this shell is distorted and maxima, minima and saddles appear. The maxima 
correspond in number, location and size to the localized pairs of electrons assumed in the 
Lewis and VSEPR models of electron pairs. A local charge concentration is a Lewis base or 
nucleophile, while a local charge depletion is a Lewis acid or electrophile, and a chemical 
reaction corresponds to the combination of complementary features of the VSCC of the base 
and acid. The Laplacian distribution can thus be used to locate possible sites of nucleophilic 
attack, and to predict characteristics (such as hydrogen bonding) of the chemical reactivity in 
general. 


Stationary points in V’p(r), points of maximum charge concentration or depletion, are being 
extensively applied in studies of basicity and acidity [47,48,49,50,51,52]; to more general 
reactivity [53,54,55,56]; in accounts of molecular geometries [57]; and to directionality of 
hydrogen bonding [58,59]. Such points may generally be associated with either bonded or 
non-bonded electron pairs. Experimental determinations of V’p distributions are included in 
[60,61,62]. 
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The XD System Files and the Master Control 
Program 


2.1 File Name Conventions 
The xd files are named according to the convention 


xd(_model-id)(_property | program).type 


The prefix Xd serves to distinguish the file as an XD system file from others that the user may 
want to keep in the same directory. The fields in parentheses are optional. 


2.1.1 The Model-Id Field 


The modelid field can be used to distinguished different refinement models. It is applied to the 
parameter file and related files only when the model id is specified on the command line (cf. 
Section 2.11). 


2.1.2 The Property Field 


The property field refers to the property used for the calculations, it is mainly used for grid 
files and output from the property program. 


rho electron density 

defden deformation density 

gradrho gradient of the electron density 
d2rho Laplacian 


esp electrostatic potential 
fou Fourier map 
fft Fourier map 
core core density 


valence valence density 

nucpot nuclear potential 

Sigrho error ofthe electron density 
Siglap error of the Laplacian 


2.1.3 The program Field 
The program field specifies the program which created the file. program can be ini, lsm, 
pro, geom, fft or fou. 
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2.1.4 The File Type 


The file type can be one of the following. A * marks files for which the modelid can be used. 
Filenames for which the property field is applied are marked with a t, while those which make 
use of the program field are marked +. 


File type can be one of the following: 


mas the master file 

cyc cycle information 

hkl reflection data 

out** list-able output 

inp* see res 

res* all atomic and all refineable parameters 
fou* Fourier file (binary) 

cov* variance-covariance matrix (binary) 
der* matrix of structure factors derivatives (binary) 
mat* normal equation matrix (binary) 

grd*' property on a grid 

pth* bond path 

cps* critical points 


2.1.5 Examples of File Names 


xd.mas (master file) 

xd lsm.out (least squares results listing) 

xd.res (least squares parameter file on output) 
xd.fou (Fourier reflection file) 

xd.cov (variance-covariance matrix) 


xd defden.grd (deformation density on a grid) 


2.1.6 The Cycle Field and the Cycle File 


The cycle field is applied only in case the file xd.cyc is present. In this case it is used to add 
cycle (version) numbers to the . res file. XDLSM usually reads from xd. inp and writes to 
xd.res. The cycle file contains instructions about the cycle to read and the first cycle to 
write. It consists of the single line 


READ rdcyc WRITE wrcyc 


If the read cycle equals zero, xd. inp is read. If the write cycle equals zero, the behaviour is 
undefined. After each refinement cycle, XDLSM sets rdcyc to wrcyc and increments wrcyc by 
one. After the last cycle, the new values are written to xd.cyc. When XDLSM is run again, it 
reads the last parameter file written and continues to write new parameter file following the 
existing ones. In case XDLSM dies before finishing the last cycle, no new cycle file is written 
and possibly created parameter files of this run are ignored. 


In case the cycle naming scheme is to be used, one starts with READ O WRITE 1 after xdini 
has run. There is no need to touch the cycle file after that if things go right. To restart the 
refinement from a specific cycle, edit the READ field. The WRITE field only needs to be edited 
if parameter files should be overwritten after a successful run of XDLSM or, conversly if 
parameter files should not be overwritten after an unsuccessful run. 
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Note, that the cycle mechanism is only available on platforms which support multiple periods 
in file names (Unix/Linux and Windows all accept this mechanism). 


2.1.7 Examples 


xd.mas (master file) 

xd lsm.out (least square results listing 

xd.res (least square parameter file on output) 
xd.fou (Fourier reflection file) 

xd.cov (variance-covariance matrix) 

xd defden.grd (deformation density on grid) 


2.2 The Master File xd.mas 


Execution of the component programs of the XD package is started by a master control 
program directed by a master file. 


xd.mas is a free-format ASCII file. A line beginning with the exclamation mark (!) will be 
treated as a comment. This allows the user to keep all instructions in the file even if many of 
them are not in actual use. A single line can have up to 256 characters. If a line ends with a 
backslash (/), the next line will be read as a continuation line. The total length of a 
concatenated lines can be up to 256 characters. The input is not case sensitive. Two special 
tokens, +inf and -inf, can be used in places where numbers are expected. They represent plus 
and minus infinity. 


The master file contains all instructions and options needed by all the programs of the XD 
package. It is created by XDINI which provides an interface between XD and other commonly 
used crystallographic packages. The master file is divided into segments. Each program has 
its own input segment. The only segment which is shared by all the programs contains only 
general crystallographic information. Each line in a segment begins with a mnemonic string, 
usually followed by further keywords and/or numeric strings offering different sub-options or 
assigning default values to variables. In case of a multiple choice a sub-option can be selected 
by the asterisk (*) right before the corresponding keyword. Multiple flags, if not otherwise 
specified, are generally not allowed. Their presence should not normally terminate the 
program, but only the last selected option is actually activated. 


A segment should begin with the module name as follows: 

MODULE (*)xdprogram 

where xdprogram is one of the program names (for example XDLSM, XDFOUR or XDPROP). A 
new line is read until the 

END xdprogram 

card which is the normal way to terminate the program. 


A special type of input section is a structured sub-segment what can be called a table. It isa 
set of lines with ordered alphanumeric fields. The first row is a heading composed of 
keywords showing the content of the columns. The first keyword in this row serves as Table 
Identifier (T) the others are not interpreted (one can’t use them to change the order of the 
fields, for example). No field can be skipped but the last one can always be omitted if a default 
value is available. A table ends with the END TI instruction. 
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Example: 


ATOM atom0 axl atoml atom2 ax2 r/l tp tbl kap lmx sitesym chemcon 
O(1) O(2) X O(1) C(1) Y R 2 1 1 4 NO 
0(2) O(1) X 0(2) C(2 Y R 2 1 1 4 NO O(1) 


END ATOM 


2.2.1 General instructions 


The master file begins with a section containing basic crystallographic data, common to all 
programs, as follows. 


2.2.1.1 TITLE 


TITLE compound-id title-string 

The first eight characters serve as a compound identifier (CID) which is used to check if 
certain files belong together. The CID found in the first record of xd. hk1l and xd. inp files 
has to match with that in the master file, otherwise XDLSM terminates with an error message. 


2.2.1.2 CELL 


CELL a [1] b [1] c [1] alpha [90] beta [90] gamma [90] 
Unit cell parameters are given in À and degrees. Default angles are 90 degrees, default axis 
lengths 1 À. 


The additional entry CELLSD may also be given. It is used by XDGEOM (Chapter 5) to 
compute errors on derived parameters which take the cell errors into account. 


CELLSD o(a) o(5) o(o) o(alpha) o(beta) c(gamma) - no defaults 
2.2.1.3 WAVE 


WAVE wavelength 
Radiation wavelength in A. 


2.2.1.4 LATT [C P] 


LATT centrosymmetry-flag lattice-type 

The centrosymmetry flag must be given as either A (non-centrosymmetric) or C 
(centrosymmetric). Lattice type may be P, I, R, F, A, B, or C. Rhombohedral lattices indexed 
on hexagonal axes (lattice type R) must be given as the obverse cell (-h+k+ł=3n). Note that 
rhombohedral lattices indexed on rhombohedral axes have lattice type P. 


2.2.1.5 SYMM 


SYMM general-position-coordinates 

SYMM tx rll r127r13 ty r21 122 123 tz r31 132 133 

The positions may be given exactly as in the International Tables, the three coordinates being 
separated by commas (spaces are insignificant here). Alternatively, the operator elements may 
be separated by spaces (with no embedded spaces). Positions generated by a center of 
symmetry or corresponding to lattice centering should be omitted, and the origin must be at 
the center of symmetry in centrosymmetric structures. The entry 'SYMM X,Y,Z' is always 
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assumed and will be ignored if given. More than one position may be given within one SYMM 
entry, if desired, by placing a semicolon between each of them, e.g. for space group I 4; (no. 
80): 


LATT A I 
SYMM  -X, -Y, Z; -Y, 1/2+X, 1/442; Y, 1/2-X, 1/4+2 
or a SYMM entry may be given for each position. 


The symmetry operation can also be written in a purely numerical way by giving a translation 
vector and a 3x3 rotation matrix, for example: 


SYMM 0. 0. -1. 0. 0.5 1. 0. 0. .25 0. 0. 1. 


Note, that a mixture of the two ways of giving a symmetry operator (SHELX-type input) is not 
allowed. 


2.2.1.6 BANK [CR SCM BBB] 


BANK databank type 
The databank type can be CR, BBB or SCM (see Section 2.5 for a description). In the absence 
of the BANK instruction, the databank CR is used as default. 


2.3 The parameter file xd.inp and xd.res 


Type: free-format, sequential 

These are the input and output parameter files of XDLSM, and contain the information needed 
to calculate the electron density and related properties by XDPROP. xd.res is overwritten 
after each least squares cycle. See Table 2-1 for a detailed description. 


Important! These files should not normally need to be edited. 
Many entries are also present in the master file. Specifications given in the master file have 


the priority. It means that the xd.inp and xd.res may differ according to any changes 
made in xd.mas. 
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Table 2-1: The content of the parameter file (the previous format is still 
accepted and interpreted by the code). The order of the parameters 
(Uij, Uis, Uijki, Pin, exten) corresponds to the list given in Table 4-2 


Record Content Description 
1 xdparfile version [1/ 2] version of the parameter file (1 is the older, 2 
the most recent one) 
2 cid Compound identification 
3 nat, ntx, lmx, nzz, nto, nsc, ntb, | software limits for some parameters 
nov 
4 (kv(y),i=1,14) Dimensions of certain arrays in XDLSM, see 
table 4.1 in Chapter 4 for their meanings. 
1: number of atoms (na), 2: number of 
displacement tensor components (ntmx), 3: 
maximum level of multipole expansion 
(npolmax), 4: number of kappa sets (nz), 5: 
not used (nto), 6: scale factors (nq), 7: 
extinction model (next), 8: number of 
constraints (ncon), 9: number of scattering 
factor tables (ntb), 10: number of symmetry 
cards (ns), 11: number of variables (nv), 12: 
(nqq), 13: number of cycles (nc), 14: number 
of dummy atoms (nad) 
5 rlo, r20, rl, r2, rlw, r2w, gof, | Statistics of the fit 
sig 
6 a,b,c, d,e, f Parameters of the lsq weigtht 
7... +nad dx(i), dy(i), dz(i) Dummy atom coordinates 
do n-1,na 
+1 atom, Atom name (character*8) 
icor1, icor2, nax, nay1, nay2, Code integers for defining the site coordinate 
jtf, itbl, isfz, Imax, isym, ichcon, system, 
The order of displacement tensor, scattering 
factor number, kappa set, max. level of 
spherical harmonics used, site symmetry 
code, chemical constraint, 
+2 x, y, z, amult Coordinates, multiplicity 
U for jtf{n)=1 or Uj for jtf(n)22 Isotropic or anisotropic U 
+3,+4 Uii for jtfin)23 3. order anharmonic tensor components 
+5...47 Uii for jtf(n)-4 4. order anharmonic tensor components 
+8...+10 (Plm(j),j-1,npx) Multipole populations 
npx-lmax*lmax*2* lmax*2 
end do 
+1...tnzz | ifz(),(z(j,),j-0,lmax*2) Scattering factor table to which the ith kappa 
set refers, 6 kapp values 
*1 (extcn(i) ,i=1,7) Extinction parameters 
+1 out Overall thermal parameter 
+1 (sc(i),i=1,nsc) Scale factor 
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2.4 The reflection file xd. hkl 


Type: free-format, sequential 
An input file containing the observations. It consist of as many records as observations are 
available. See Table 2-2 for a detailed description. 


Table 2-2: The content of the reflection file. 


Record Content Description 
1 cid, Compound ID 
fcod, F or F2 
NDAT ndat Number of entries for each observation (min.-6, max.-13) 
DO N-1,NREF 
h,k,l Reflection indices 
iscgrp, Scale group number 
obs, F or F2 as given by fcod 
sigobs, Sigma(F) or sigma(F2) 
tbar, Path length 
ul,u2,u3, Direction cosines of a vector defined with respect to the real 
crystal axes and normal to the plane of diffraction 
v1, v2, v3 Direction cosines of a vector defined with respect to the real 
crystal axes lying in the plane of diffraction and 
perpendicular to the incident beam 
end do 


2.5 The databank files xd.bnk * 


Type: free-format, sequential 


These files contain ground-state STO-HF atomic wave functions for elements from H to Xe 
including chemically relevant ions. The basis functions are Slater type orbitals of the form: 


= (n-1) 
bz EE Not i exp(—C Xa 
An atomic function is 


d, = Y, Y 536, 
k 


Where Yn are complex spherical harmonics. The orbital coefficients C and exponents ģ are 
stored and used to calculate core and valence scattering factors according to a given electronic 
configuration. Additional data are also stored. A segment for an atom contains the entries 
given in Table 2-3. The files can be extended by introducing new segments identified by new 
atomic symbols. The element names are those conven-tionally used; first character upper 
case, second (if any) lower case. For ions the element name is followed by the order of 
ionization and the sign. Correct element names are: H Na Cu2+ F- 


Important! One should not modify the values of the available entries. This can be done, if 
necessary, in the xd.mas file with the SCAT table entries. 
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Table 2-3: The content of an entry in the databank file. 


Record Rec.-Id Entries 
1. :ELEM zw dfpmo dfppmo dfpcu dfppcu sctl ira irc irn 
elem Element symbol (H, Cu, Ti3+, ...). It serves as the segment's 
identification 
Z atomic number 
w atomic mass 
dfpmo anomalous correction for Mo radiation (Af) 
ddfpmo anomalous correction for Mo radiation (Af") 
dfpcu anomalous correction for Cu radiation (Af) 
ddfpcu anomalous correction for Cu radiation (Af") 
sctl Coherent neutron scattering length 
ira Atomic radii 
irc Covalent radii 
irn Van der Walls radii 
2. SPH al bl a2 b2 a3 b3 a4 b4 a5 b5 a6 b6c 
expansion coefficient for analytical approximation of the RHF 
spherical atomic scattering factors. For the hydrogen atom see 
Stewart et al [63] 
3 SZ (zet1(i),i=1, 12) 
zetl Single-G exponents used for the radial functions of the valence 
deformation density [63] 
4. STO ((orb(i), ioc(i), nbf(i)), i=1, 12) 
orb Orbital type (1s,2s,3s,4s,2p,3p,4p,3d,4d,4f,5s,5p) 
ioc Occupation - negative number refers to valence electrons 
nbf Number of basis functions 
5. (((bc(ij), bx(i,j), nr(i,j)), j= 1, nbf(i)), i= 1,noc) 
be Coefficient of the basis function (C) 
bx Exponent of the basis function (6) 
nr n 
noc Number of occupied atomic orbitals (ioc(i)«0) 


The databank file xd. bnk, distributed in the previous versions of XD (up to Rev 1.14, 1999), 
is no longer usable because the introduction of new wave functions and analytical scattering 


factors required some changes in the format. 


Three new databanks are now available: 


xd.bnk RHF CR: (flag CR) 


This contains the original XD databank in the new format. Clementi and Roetti [20] wave 
functions are tabulated for all neutral atoms and principal ions up to Kr. Single-8 functions 
are taken from Clementi and Raimondi [63]. Analytical spherical scattering factor are from 


International Tables [64]. There are two changes with respect to the original file: 


e For the metals Cr and Cu (both 4s!3d™!), the 4s orbital is now included in the 'core' in 


agreement with the default convention adopted for all other transition metals 


e The analytical spherical scattering factor (SPH) is now written with 13 entries: 


(a(i), b(i), (i=1, 6)),c. Because the standard expansion of International Tables is up to i 


entries 9-12 are 0.0; the 13t entry is the constant term (which used to be the 9t entry, 


when only nine fields were present in the old file). 
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xd.bnk RHF BBB: (flag BBB) 


Wave functions are taken from non-relativistic calculations by Bunge et. al [65] and include all 
neutral atoms up to Xe. Single-€ functions are taken from Clementi and Raimondi [63] or 
Clementi and Roetti[20] (for atoms of the 5 row). All the other parameters are identical to CR 
databank. 


xd.bnk RDF SCM: (flag SCM) 


Wave functions fitted to a relativistic Dirac-Fock solution are taken from Su and Coppens [66] 
for neutral atoms up to Kr and from Macchi and Coppens [67] for neutral atoms Rb-Xe and all 
chemically relevant ions up to I. The analytical spherical scattering factor is taken from the 
same publications, where a six-term fitting was used (without constant term). Single-& 
functions as for databank BBB. 


Sample databank entry 


:C 6 12.0110 0.0033 0.0016 0.0181 0.0091 6.646 77 77 185 
SPH 2.3100 20.8439 1.02 10.2075 1.5886 0.5687 0.865 51.6512 0.000 0.000 0.000 0.000 0.216 
SZ 5.6727 1.6083 0.0000 0.0000 1.5679 0.0000 0.0000 0.0000 0.0000 0.0000 
0.0000 0.0000 
STO ls 2 6 2s -2 6 2p -2 4 
0.932620 5.435990 1 0.069310 9.482560 1 0.000830 1.057490 2 -0.001760 1.524270 2 
0.005590 2.684350 2 0.003820 4.200960 2 
-0.208140 5.435990 1 -0.010710 9.482560 1 0.080990 1.057490 2 0.750450 1.524270 2 
0.335490 2.684350 2 -0.147650 4.200960 2 
0.282410 0.980730 2 0.546970 1.443610 2 0.231950 2.600510 2 0.010250 6.510030 2 


2.6 The Fourier file xd.fou 


Type: unformatted, sequential 

A Fourier file created by XDLSM, if requested, after the last least-squares cycle. It has as 

many records as observations were included in the structure factor calculation. Each record 

contains the following entries: 

h k l fobs sig phase amod1 bmod1 amod2 bmod2 

where 

h, k,l reciprocal lattice components of the scattering vector 

fobs | observed structure factor corrected for anomalous dispersion 

sig error of fobs 

phase phase calculated with the final parameters according to the model the refinement was 
based on 

amod 1 real part of the calculated structure factor (fmod 1) based on an input dependent model 
(MODEL1) 

bmod1 imaginary part of fmod1 

amod2 real part of fmod2 

bmod2 imaginary part of fmod2 


2.7 The design matrix xd.der 


Type: unformatted, sequential 


(D(i.j).j^ 1, nv), i- 1,nref) 
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where D (real*8) is the matrix of derivatives of the structure factors with respect to the 
parameters refined (design matrix), nv and nref are the number of variables and observations, 
respectively. 


2.8 The normal equation matrix xd.mat 


Type: unformatted, sequential 

(B(ij),j-G nv), 6 y(U, t= 1,nv) 

where B and ôy (real*8) are the coefficient matrix and vector of the system of least square 
equation and nv is the number of variables refined: 


BG, j) = Doh, k,D * d|F (h,k,D|/ dp, * d|F (h,k, D|/ dp, 


hk 


Sy) = $e, kD * d|F (h,k, D|/ dp, * (F, — F,) 


h,k,l 


2.9 The variance-covariance matrix xd.cov 


Type: unformatted, sequential 
See Table 2-4 


Table 2-4: The content of the variance-covariance file. 


nv, errwt (real*4) Number of variables, square of GOF 

((A(ij), j=t, nv), i7 1,nv) A = inw(B) * errwt, where B is the least squares matrix 

(real*4) 

(iatom(i),i=1,nv) > O the sequence number of the atom to which parameter i relates 


= 0 iis not an atomic parameter 
< 0 point to Kappa set 


(itupe(i),i- 1,nv) The order number of parameter i as described in Table 4.2 
(isfz(iatom(i)),i- 1,nv) Kappa set 
if iatom(i]- 0 


2.10 Grid and path file format 


Type: formatted, sequential 
See Table 2-5 below 
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Table 2-5 The content of grid and path files. 


Record Content Description 

1 filtype version filetype can be any of 2DGRDFILE, 3DGRDFILE or 
PATHFILE. version gives the version number of the file 
format (currently 0). 

2 cid property Compounf id and name of the mapped property 

3 title Title string 

4 nx ny (nz) Number of grid points 

5 ox oy oz Origin of the grid in 'world-coordinates' 

6 xdim ydim zdim Physical size of the grid (in À) 

7 no Number of objects 

+1...+no name x y z (type) type is either ATOM or CP 

+1 nc Number of connections 

*l...*nc object1 object2 List of bonds or other connecting lines to be drawn 

The body for grid files 

values List of grid values, x varying fastest. 

The body for path files 

+1 ncurve Number of bond path curves 

ncurve times 

+1 object npoints type | object gives a starting point (usually a CP object). 

+1...+npoints xyz type is BOND. 


2.11 XD - The Master Control Program 


SYNOPSIS 
xd (options) (cid (mid)) 


OPTIONS 


-v 
be more verbose (in XD itself, does notinfluence the output of individual modules) 
-d 
debug mode, show which commands would be executed, do not actually start them 
-e <exclude-list> 
modules not to start, although they might be flagged in the master file 
-i <include-list> 
modules to start, whether flagged in the master file or not 
-o <only-list> 
exclude all modules not mentioned in this list 


DESCRIPTION 


The modules flagged 'active' in the master file (xd.mas) are started. (Subject to change with - 
i, -e, -o switches). The parameters cid and mid are passed to each module. If no master file 
can be found, XDINI will be started. 

It is also possible to start each program by its own command: 

xdini cid (prgname, databank source) 

See Chapter 3 for details about starting XDINI. 

xdlsm cid (mid) 

xdprop cid (mid) 
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xdfour cid (mid) 
xdgeom cid 
xdfft cid 
xdgraph options 
topxd 


See Chapter 9 for details about starting XDGRAPH. 
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Chapter 3 


XDINI - Importing Data into XD 


XDINI provides an interface between XD and certain crystallographic computer packages used 
to solve and refine the structure. It creates the master file with default options and settings, 
the corresponding input-parameter (xd. inp) and data files (xd. hk1) for XDLSM. An output 
flle (xd ini.out) is also written. The program either requires keywords given in the 
command line or input from the file xd ini.inp. The current version supports data 
transfer from SHELX (SHELXL), CIF, XTAL and MOLLY files. It also accepts free-format, as 
well as fixed-format data files, making it possible to communicate with other computer 
packages. The files created by XDINI need to be checked. The default setting corresponds to a 
spherical-atom refinement. It is necessary to edit and modify the ATOM table in the master 
file before switching to multipole refinement. The default definition of the atomic site 
coordinate systems are based on the connectivity (the two closest neighbours together with 
the atom considered define the Z,X plane). This is, in most of the cases, not appropriate for 
site symmetry implementations. The level of the multipole expansion (the default is monopole) 
as well as the number of kappa sets should be extended. The xd.inp and xd.hkl1l files 
usually do not need to be modified. 


3.1 Instructions for XDINI 


3.1.1 Command line mode 


In the command-line mode, no xd ini.inp file is required. The following simple syntax 
can be used: 


xdini cid prgname bnkname 
(e.g. xdini test shelx SCM) 


cid is a maximum 8 character long compound identification described before and prgname can 
be shelx, cif, xtal and molly with the following input-file requirements: 


prgname filel file2 file3 

shelx shelx.ins - shelx.hkl 
cif xd.cif - xd.fcf 
xtal xtal.inp xtal.stm xtal.hkl 
molly molly.inp molly.par molly.hkl 


The files file1-3 are read, each after the other, in the order given above. If any of them is not 
found or its interpretation failed, XDINI turns to its standard input file, xd ini.inp, for 
further instructions. 

bnkname can be CR, BBB or SCM (see section 2.5 for their meaning). If bnkname is not 


specified, xd.mas will be generated with the default BANK CR. 
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3.1.2 File directed mode 

xdini cid 

The input file (xd ini.inp) consists of three segments: general crystallographic, parameter 
and observation input. The first one corresponds to that in the master file containing the 


instructions TITLE, CELL, SYM, LATT and WAVE, among which the first two always have to 
be given. The latter two segments have common instructions described below. 


3.1.3 FILE 


FILE filename 


The data are read from the input file xd_ini.inp unless otherwise is specified. The FILE 
instruction redirects the default input to a file named filename. 


3.1.4 FORMAT 


FORMAT (format specification) 


The data are supposed to be given in default order and in free format. If this is not the case a 
proper format instruction (standard FORTRAN) is to be given. The format specification in 
parentheses must be divided by a blank from the FORMAT command. 


3.1.5 Default atomic parameter list 
The following entries have to be given for each atom: 


atomname x y z mult uiso or 
ull u22 u33 ul2 ul3 u23 


The atomname (up to eight characters) should start with a proper element symbol followed by 
any character string. It is transformed to the atom identifier standard to XD (NA11 to Na(11) 
or h2a to H(2a)). x, y and z are fractional coordinates corresponding to the cell dimensions 
given by the CELL card. The last two entries, the atomic site occupation factor (mult) and the 
isotropic thermal parameter (uiso) can be omitted if the atom is in general position and 
anisotropic displacement parameters are supplied in the next line. 


3.1.6 LOADPAR 


LOADPAR nat (npar) 
Followed this command line nat atom segments are read. The parameters have to be either in 


the order specified above or according to a format statement given previously. In the latter 
case the number of entries (including atomname) for each atom has to by given by npar. 
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3.1.7 DTYP 
DTYP u|b|beta 


This instruction specifies the type of the displacement parameters in the atom line. A general 
expression for the anisotropic atomic thermal parameter is 


(eno Da with i> j= 1, 2,3 
ij 


For the three options above the constants (di) and the displacement amplitudes (Ai) take the 
following forms: 


dtyp di Aij 
u 212aiajhihj(2 - 8i) Uy 
b aiajhih(2 - i) Bj = 8n2Uy 
beta hih{2 - 5i) by = 212aiajU; 
where 
1 fori= j 
? \0 for iz j 


ai are reciprocal axis lengths and hi are the corresponding components of the scattering vector. 
If the input displacement amplitudes are in the form of b or beta they are transformed to u as 
required by XDLSM. 


3.1.8 SCALE 

SCALE (sc(i),i=1,nsc) [1.0] 

nsc number of scale factors are read in. If omitted the data are supposed to be on absolute 
scale forming one scale group. 

3.1.9 Default observation input 

The following entries can be given for each observation: 

h k l obs sigobs scgrp tbar ul u2 u3 v1 v2 v3 

These symbols are described in the previous chapter in connection with the reflection file 
xd.hkl. The first 5 entries always have to be given, all others are optional. 

3.1.10 LOADREF 

LOADREF F or F^2 nref ndat 


nref observation line, containing ndat entries with F or F? data, are read either in the order 
specified above or according to a format statement given previously. 


3.1.11 SORT 
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SORT (index1 [h] index2 [I] | sinthl) 


The reflections are sorted either with respect to indices (index1 varies first and index2 last) or 
to the absolute value of the scattering vector (sinthl). An ‘in-memory’ sorting algorithm is 
implemented which can handle 15000 reflections. If more data are to be sorted the parameter 
NO is to be changed in the source. Proper sorting with respect to indices speeds up the 
Fourier calculations. It is mentioned here that XDINI does not average symmetry equivalent 
reflections and neither does XDLSM. It is advised to enter into XD with unique (symmetry- 
averaged) data unless anisotropic extinction refinement is to be carried out. 


3.1.12 END 


END 


The END card closes the xd ini.inp file and terminates the program. 


3.2 Examples 


Example 1. 


TITLE oxal (free format atom list) 
CELL 6.093 3.469 11.9257 90. 105.69 90. 
SYMM 1/2-X, 1/2+Y, 1/2-Z 


LATT C P 
SCALE 3 85.87513 89.84698 369.09409 
LOADPAR 7 
O1 0.085335 -0.055242 0.150354 

0.006503 0.009821 0.003786 0.002344 0.001042 0.000470 
02 -0.221518 0.244985 0.036284 

0.005563 0.009277 0.005550 0.002939 0.001704 0.000386 
03 -0.451596 0.634692 0.178431 


0.006991 0.009768 0.005222 0.001231 0.002255 0.000790 


H3 -0.373817 0.487426 0.152675 1.0 0.03 
FILE ox.hkl 

LOADREF 1500 6 

SORT sinthl 

END 
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Chapter 4 


XDLSM - Least Squares Program for Multipole 
Refinement 


4.1 Overview 


XDLSM is a full-matrix least squares program based on the generalized scattering model 
detailed in the introduction. Its present version includes multipole expansion up to [=4 and 
anharmonic treatment of the thermal motion up to 4th order of the Gram-Charlier expansion. 
XDLSM, being based on the Hansen-Coppens formalism [68], necessarily has many common 
elements with MOLLY, the algorithm of which has been rebuilt and extended to allow for 
further developments. XDLSM supports sophisticated density modelling, and features of 
previous refinement programs have been incorporated (LSEXP [69]). Further important 
aspects of XDLSM provide methods to locate inadequacies in the model, to control the 
refinement and to monitor the result. 


4.1.1 The method of least squares 


In this chapter some aspects of the method of least squares are discussed, whose knowledge 
are necessary for the user to handle the input and output of XDLSM. This introduction is 
based on reference [70], to which the reader is referred for more details. 


Consider a given set of m observations YofYo1,Yo2, Yos,... Yom} represented by the corresponding 
set of model functions yefyc1, Yc2,Yc3,..-Ycm}=Ye(X), where x is the n-component vector of the 
parameters x{x1,X2,X3,...xn}. The best unbiased estimates of x can be obtained by minimizing 
the square of the residual: 


R'-(y,-y)W(y,-y)-(,-y.))Q'Q(y,-y.) (Eq. 4.1) 


where W, the weight matrix, is to be chosen as the inverse of the variance-covariance matrix of 
the observations (in practice, it is taken diagonal), and Q is an upper triangular matrix, i.e. 
Q'Q is the Cholesky decomposition of W. If ye can be expanded about xo in Taylor's series 
retaining only the first order terms, then 


y, - y, (x,) -D(x- x,) (Eq. 4.2) 
with Dy=dyci/ dx; being the design matrix. Eq. (4.1) becomes: 
R? x [Ay - ZAx]'[Ay — ZAx] (Eq. 4.3) 


where Ay — Q(y, ei (x, )), AxX-Xx-X, and Z-QD. 
The n conditions 


2 
t3 =0 for i= 1,2,3...n (Eq. 4.4) 
Xi X;-X, 


“oi 


lead to the system of normal equations 
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Z'ZAx = Z'Ay (Eq. 4.5 
whose solution vector is 

x=x, +B 'Z'Ay (Eq. 4.6) 
with B-ZZ. 


An alternative solution of the least-squares problem is provided through the singular value 
decomposition of the standardized design matrix Z. Let 


Z = UGV' (Eq. 4.7) 


where U is an mxn column orthogonal matrix, G is a diagonal matrix of the singular values 
and V is an nxn orthogonal matrix. 


A solution of the over-determined system of equations 


ZAx = Ay (Eq. 4.8) 
can be given as 

Ax = Z'Ay (Eq. 4.9) 
where 

Z'=VG'U' (Eq. 4.10) 


This solution can be proved to be the best possible solution in the least-squares sense as x 
is the vector which minimizes the residual: 


R=(|ZAx — Ay (Eq. 4.11) 


The solution of the least-squares problem through the system of normal equations (4.6) has 
the disadvantage that it fails if B is singular or ill-conditioned. A difference should be made 
between ill-conditioning of an analytical and that of a numerical nature. The former case is 
likely to occur for an over-parametrized model, when some combination of basis functions are 
irrelevant to the fit. The normal equation matrix has zero or nearly zero eigenvalues and the 
inversion gives no or only a formal solution. This problem manifests itself in undesirable 
correlations among the variables. The method used for establishing hidden indeterminacies in 
the model is the singular value decomposition of the matrix of observation-equations (4.8). 
This procedure gives a diagnosis of the degeneracies and provides a solution minimizing the 
residual. The matrix can be considered ill-conditioned if its inverse condition number, the 
ratio of the smallest to the largest eigenvalue, is comparable with the machine precision. The 
components of the eigenvector (a row or column vector of V) corresponding to the smallest 
eigenvalue define a linear dependence among the variables (orthonormal basis for the null- 
space) which leads to the singularity. Zeroing an eigenvalue in the calculation of the inverse 
matrix (4.10) means introducing the constraint given by the corresponding eigenvector. The 
term numerical ill-conditioning refers here to an unbalanced least-squares matrix which is due 
to the fact that the model function is simply not equally 'sensitive' to the changes of the 
different parameters, ie. the components of the design matrix can differ by many orders of 
magnitude. A condition number of the order of 10 is typical for the multipole-model based 
structure factor least-squares matrix. This number indicates that a small change (error) in an 
element of the design matrix (Z) can cause large changes in the elements of B-t. That is why 
the solution via the inversion of the normal equation matrix is susceptible, to a considerable 
extent, to roundoff errors and requires double precision arithmetic. This problem can be 
overcome if the elements of the Z (or B) matrix are brought to a common scale. In XDLSM the 
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normal equation matrix is analyzed and its conditioning is accomplished by a similarity 
transformation: 


B, = diag(B) "^ Bdiag(B) (Eq. 4.12) 


Inversion, based on the Gauss-Jordan elimination method [71], is the default option to solve 
eq. (4.5). If the matrix inversion fails or if diagonalization has been selected as the method of 
solution, the eigenvalues are calculated by the Jacobi method [71], and the singularities are 
reported and eliminated. The eigenvalue filtering is based on the inverse condition number. 
The lowest eigenvalues are rejected (zeroed) from the inverse calculation until the inverse 
condition number reaches a user specified limit. While this procedure gives a mathematically 
correct solution, its indiscriminate application does not necessarily reveal the physical 
meanings of the indeterminacies that made the least-squares equations singular or nearly 
singular in the first place. 


4.1.2 Model ambiguities 


The XD package will be available for a wide scientific community. This Section tries to help 
those who have not yet been involved in charge density research. In particular, it tries to help 
those users who have not yet had the uncomfortable feeling of getting stuck at a certain stage 
of the refinement. This happens when decisions need to be made as to which parametrization 
is preferable among several alternative ones which perform equally well in fitting the data. 


The scattering model described in the Introduction formally allows 66 parameters per atom (in 
the present implementation of XD) to be included in the refinement. However, any 
interpretation of the data set using an 'all-parameter' fit is hardly feasible, nor is it 
appropriate. Even if one could afford it (Le. even if enough data points were available) and 
even if convergence was reached with a satisfactory fit, the physical significance of the results 
would certainly be doubtful. While the total dynamic ED obtained could account for the data 
very well, any property which is a function of a subset of the variables could well be 
meaningless. As mentioned above, the reason for this is that many basis functions of the 
structure factor expansion have a similar dependence on the components of the scattering 
vector. Consequently the data cannot differentiate between them. A typical example of this 
type of bias is that introduced into the static density deformations by the inadequate 
decomposition of the thermal smearing. This is caused by the formal similarity between 
density basis functions and pdf’s of the nuclear displacements. Strong correlations, as high 
as 80-90%, are likely to occur between quadrupole populations and second order 
displacement parameters. The Gram-Charlier model has been shown to be as adequate as the 
multipole expansion in accounting for static density asphericities [72]. Such indeterminacies 
can appear especially pronounced for non-centrosymmetric structures. 


The flexibility of the model and the limited number of observations forces one to limit the 
optimization to a subset of parameters or to their combinations. The variables are usually 
selected on the basis of simple chemical arguments or preconceptions. The outcomes must be 
tested in order to judge their physical significances. A careful study should not neglect an 
independent analysis of static and dynamic parameters. 


4.1.2.1 Testing the results 


The most important test to judge the success of the model and the quality of the fit is to 
evaluate the residual ED through a Fourier summation (Fobs - Fimodei). This provides a direct- 
space representation of the extent to which the model accounts for the observations. A 
featureless residual map is a necessary condition for the adequacy of a model, but is far from 
being a sufficient one for judging its physical significance. Another usual procedure is to 
compare the static deformation density obtained from X-ray data with that calculated 
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theoretically. Deformation peak-shapes and peak-heights are subject to specific conditions 
that are characteristic for the different methods to be compared. The ab-initio ED depends on 
the level of the theory applied and on the quality of the basis sets. Both factors place severe 
limitations on any direct comparisons, especially for larger systems. However, without such 
comparisons, the interpretation of the results in terms of the deformation ED remains only of 
a qualitative nature. This is because of the arbitrariness in selecting the reference state and 
the sensitivity of the ED to the structural parameters. 


We suggest that the experimental ED is tested through its local and global topological 
characteristics and by evaluating its integrated properties. XDPROP makes it feasible to trace 
the refinement process almost 'continuously' by inspecting the different stationary points of 
the total ED and related scalar properties. In this respect the Laplacian of the ED, as a 
sensitive measure of charge concentrations, should play an important role. A static ED which 
fails to reproduce the characteristic topological features of a typical covalent bond, e.g. (3,-1) 
CP's, bond charge concentrations shown by the Laplacian, is likely to be suspect. 


One-electron properties are directly obtainable from the ED and their comparison with the 
outcomes of independent measurements and/or theoretical results are of great importance. 
The molecular dipole moment and the electrostatic potential are the quantities most 
frequently evaluated from the experimental ED. Such applications are being explored with a 
promising success. 

One way to gain information on the physical significance of the thermal parameters is to test 
them against the rigid-body motion model [73] which is based on the observation that in 
molecular crystals the external (lattice) vibrations make the major contribution to the atomic 
motion. Satisfactory agreement between observed and calculated anisotropic displacement 
parameters may suggest that the molecule is rigid to a good approximation or the thermal 
parameters are ‘uniformly’ affected by systematic errors. Significant residuals after the rigid- 
body fit may indicate either the importance of soft internal modes or simply a bias in the 
atomic displacements. A directly applicable test for the correctness of the atomic displacement 
parameters is the rigid-bond test [74]. 


If a g denotes the mean square displacement amplitude of atom A in the direction of atom B, 
then for every covalently bonded pair of atoms A and B 

Aue = ae eae =0 
Conversely, if in parts of the molecule this rigid bond postulate is not fulfilled, one may deduce 
that the structural model is insufficient. Hirshfeld estimated that for atoms at least as heavy 
as carbon Aas should normally be smaller than 0.001 A?. Verification of the model and the 


anisotropic displacement parameters by this test strengthens confidence in the experimentally 
determined ED. 


A very useful visualization of the atomic displacement parameters is provided by the 
computer-graphics program PEANUT [75], developed recently to analyze observed (fitted to 
diffraction data), calculated (as given by a model) or residual (observed- calculated) thermal 
parameters in terms of closed surfaces defined by the root-mean-squares displacements 
((u(n))!/2=(n'Un), where n is a unit vector in any direction). Applications are given in references 
[76]. 


A plausible approach to reduce ambiguities in the model is to introduce constraints into the 
refinement. It is desirable to replace 'external' checks on one of the possible, mathematically 
equivalent solutions by 'internal constraints applicable to support the physically most 
relevant solution. An advanced feature of XDLSM is to allow for general linear restrictions on 
any set of variables. Efforts are being made to further develop this option in order to 
incorporate more 'physics' into the refinement model. 
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4.1.2.2 Constraints in XDLSM 


The treatment of constraints in XDLSM is based on the technique of direct elimination. 
Consider a system of nc linear equations, each of which defines a constraint among nv 
variables: 


C(nc, nv)Ax(nv) = a(nc) (Eq. 4.13) 


By decomposing the matrix C 


C-PSR'- Pace (Pret Ji R|(nr.nv) 


Eq. 4.14 
0 0 l (Eq ) 


R; (nv — nr.nv) 


with S being a diagonal matrix of nr non-zero singular values (nr nc), two sets of new 
variables can be introduced: 


Axi(nr) = R'Ax Axo(nv — nr) = R,Ax (Eq. 4.15) 
where the first set can be eliminated by means of eq. (4.13) and (4.14): 

Ax: 2 S !P'a (Eq. 4.16) 
This leads to a decomposition of the unconstrained variables 

Ax = RAx = R,Ax: + R,Ax2 -R,S ! P'a + R,Ax> (Eq. 4.17) 
The equations of observations 4.2 becomes 

Ay - DR,S !P'a = DR, Ax» (Eq. 4.18) 
and the system of normal equations is reduced to 

B,Ax = R} Z'Ay, (Eq. 4.19) 
where 

B, =R)Z'ZR, and Ay, = Ay- DR S 'P'a (Eq. 4.20) 


The elimination through the singular-value decomposition of the constraints matrix has two 

advantages; 

1. the dimension of problem is reduced by the number of independent constraints 

2. the restrictions can be formulated in an automatic way as all accidental redundancies are 
easily filtered out. 

Some of the constraints mentioned below have already been implemented in a 'user-friendly' 

way, others will be available in subsequent releases of XDLSM. 


4.1.2.3 Restrictions on the multipole populations 


Electro-neutrality constraint. The sum of the monopole populations, by definition, gives 
the number of valence electrons in the molecule (unit cell). This statement is part of the 
multipole expansion formalism which involves 'atomic' partitioning and thus provides a 
particular assignment of the atomic charge to the corresponding monopole population. The 
electro-neutrality constraint keeps the unit cell neutral. In XDLSM it is possible to define any 
subset of atoms (ie. any functional group) for which the total number of valence electrons is 
kept constant. This option then precludes any charge transfer between the group(s) selected 
and the rest of the atoms in the unit cell. 
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Local pseudo symmetry, 'chemical' symmetry. Preconceptions based on chemical 
intuition can also be applied to reduce the number of multipole populations to be refined. 
One can assume a simple hybridization scheme which corresponds to the actual geometrical 
arrangement of the atoms. This is usually achieved by imposing site symmetry in a properly 
chosen local Cartesian frame and using symmetry adapted angular functions. The symmetry 
restrictions for real spherical harmonics are given in Table 4-4. Another feasible restraint is to 
keep the valence density of chemically equivalent or similar atoms to be the same during the 
refinement. This is a widely accepted practical approach in studies on larger molecules. The 
real question is how to judge the actual applicability and success of our chemical expectations 
implemented in such a way. Static equivalences might be hampered in an unconstrained 
refinement by dynamic non-equivalences of the atoms considered. Another important aspect 
is that in crystals, the 'chemical symmetries’ characteristic of the isolated molecules may not 
be preserved. Any subsequent enforcement of static equivalencies may result in the effects of 
the crystal field becoming unobservable. 


4.1.2.4 Restrictions on the radial functions 


The shape of Rls are controlled by n(J and ai (see eq. 1.19), the latter being estimated from the 
Hartree-Fock-optimized single-€ values. In case of quadrupolar atoms (which have only ss, 
sp, and pp type orbital products) the selection of a for 1 > 2 is not straightforward. The 
corresponding 'virtual' density basis functions are shown to account for bond densities [77]. 
The usual practice is to keep ar-a for all l and optimize «' scaling of a. Even under this severe 
restriction «' becomes highly correlated with the populations and convergence can be 
troublesome. In this respect, k' is by far the most critical parameter of the formalism. This 
may indicate that the constraint implemented is not adequate. Model studies on di-atomic 
molecules showed that a satisfactory fit of the HF ED with one-center multipole densities 
requires, in certain cases, highly structured radial functions while in other cases, depending 
on the level of expansion, simple Slater functions are sufficient [78]. The extent to which this 
statement applies to many-atom molecules remains to be examined. A trivial choice for 
improving the situation is the use of radial functions corresponding to extended basis HF 
atomic orbitals. In studies on transition metal complexes, the HF radial scattering factors 
were shown to be superior to those of single Slater functions [79]. 


4.1.2.5 Restrictions on the vibrational parameters 


Rigid-body or segmented-rigid-body models could be incorporated into the structure factor 
refinement. Both approaches require a linear transformation of the design matrix leading to a 
reduction in the number of dynamic variables. Severe indeterminacies, depending on the 
formalism, can be introduced. 


A more elegant alternative procedure [80] applied in XDLSM is to define rigid molecules or 
segments by invoking rigid-bond and rigid-link constraints. This is a very efficient way to 
define the degree of flexibility, but a full control requires a detailed knowledge of the 
intramolecular motion. Normal coordinate analysis, if a suitable force-field is available, 
provides the MSDA matrix associated with any normal mode. For molecules of first row 
elements, standard force fields are readily available and procedures are in general use to 
refine them against spectroscopic data. Frequencies at the HF level are typically 1096 larger 
than those of measured, and even semi-empirical methods can provide fair estimations. This 
suggests that incorporation of calculated ADP's due to intramolecular motion into the 
refinement is feasible. An easy to handle approach is to apply constraints of the rigid-bond 
(rigid-link) type to the shift of the ADP's calculated from an intramolecular force field. Such 
shifts give only rigid-body type contributions to the ADP's and the procedure preserves atomic 
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displacements due to intramolecular vibrations. The success of such applications depends on 
the extent to which the mean-field approximation is valid. Another difficulty is that the 
optimized molecular geometry needed to calculate the harmonic force field can considerably 
differ from that found in the crystal. Another approach is to start from a set of ADP’s predicted 
by the TLS model. These ADP’s satisfy the Hirshfeld condition for all internuclear separations. 
By invoking the rigid-body constraint to all covalent bonds between atoms of comparable mass 
the bias in the ADP’s can be reduced significantly. 


4.2 Refinement strategy 


A general rule, it is strongly advised that the complexity of the model should be increased in a 
stepwise manner. Each stage of the refinement could provide a hypothesis for the next step. 
In this respect it is difficult to suggest a specific scheme, in advance, according to which one 
should proceed. The spherical-atom refinement could serve as a reference for comparison 
during the whole fitting procedure. This could be followed by a restricted multipole refinement 
in which all possible chemical constraints and atomic pseudo-symmetries are applied. As 
argued above, the extent to which these restrictions should be applied depends on many 
factors. In most cases the number of observed intensity data limits the number of free 
variables. The ratio of the number of reflections to the number of variables should not fall 
considerably below 10. Atoms with the same valence and first coordination sphere should 
always be considered chemically equivalent at this stage of the fit. The spherical HF radial 
screening parameters (k) can already be included. These variables, in contrast to those 
scaling the Slater exponents (x), are much more stable and their changes should stay below 
5-109^. If the resolution and accuracy of the observations allows, the different restrictions can 
be released in subsequent refinement cycles, in the hope of testing the adequacy of the 
assumed chemical equivalences. In this way, 'second order effects' (crystal field, conformation 
differences, second neighbours, etc.) on the valence density might become visible. To decide if 
a new variable contributes significantly to the fit the ratio of its value to its standard deviation 
and the change in the goodness of fit are to be checked. More sophisticated statistical tests 
will be available in follow-up versions of XDLSM. 


Because of their low scattering power and intense thermal motion, hydrogen atoms should be 
treated with a special care. A poor model for their static density manifests itself in unreliable 
dynamic parameters and conversely, no reasonable estimate of the charge transfer can be 
obtained without meaningful displacement parameters. In organic molecules a considerable 
amount of the charge transfer occurs at the expense of charge on the hydrogen atoms. Due to 
the electro-neutrality constraint these uncertainties can seriously affect the result. To 
overcome this difficulty, the following strategies can be applied. The position and thermal 
parameters of the hydrogen atoms should be fixed at the values obtained by neutron 
diffraction, when such data are available. An overall scaling of the neutron displacement 
tensor components should be applied to account for the temperature difference (or rather the 
difference in the diffuse scattering) between the two data collections. In the absence of 
neutron data, the parameters of the hydrogen atoms could be obtained from spherical-atom 
refinement using the contracted scattering factors of Stewart et al [81]. The isotropic 
displacement parameters can then be fixed during the multipole refinement. The correctness 
of this estimation can be judged by the distance of the bonds to the corresponding hydrogen 
atoms and by their net charges obtained in such a way. The ADP's of the hydrogen atoms can 
also be estimated by fitting the rigid-body or segmented rigid-body model to the motion of the 
non-hydrogen atoms. A simple riding model could also be feasible (U(H) = 1.5 * Ueq(non-H) ). 
Such a constraint can easily be incorporated. The density asphericities of the hydrogen atoms 
can be represented by a bond-directed dipole. For those involved in a strong hydrogen bond 
an additional quadrupole can also be introduced. The RESET BOND command (Section 4.6.5) 
is very useful here to constrain X-H distances to neutron determined standard values. 
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4.3 Dimensioning 


The parameters in Table 4-1 are used in certain DIMENSION and COMMON statements. They 
can be modified according to the user’s needs. 


Table 4-1: Dimensioning of XDLSM 


Name Values Description 

nat 2000 maximum number of atoms in the asymmetric unit 

ntx 31 maximum number of displacement tensor components: 
6 Uj * 10 Uix + 15 Uia = 31 

imx 4 maximum level of multipole expansion 

nzz 30 maximum number of kappa sets 

nto 1 currently not used 

nsc 20 maximum number of scale factors 

ntb 20 maximum number of core, valence scattering factor tables 

nov 2500 maximum number of variables allowed 

ncst 200 maximum number of constraints 

nao 18 maximum number of atomic orbitals allowed in the wavefunction input for 
the scattering factors: 1s, 2s, 3s, 4s, 2p, 3p, 4p, 3d, 4d, 4f, 5s, 5p, 6s, 6p, 
5d, 7s, 6d, 5f 

mgrd 40 maximum number of grids used to store scattering factors 

grd 0.05 Step size in sin0/X 


Related to these the following parameters are also in use: 


Name Value Description 

npop imx * Imx + 2 * Imx + 2 | maximum number of multipole populations 
nap 3 + ntx + npop | maximum number of atomic parameters 
npp nap * nat + (lmx + 2) * nzz + nsc + 8 | total number of parameters 


4.4 Variable names and order numbers 


See Table 4-2 for a list of symbols and code numbers to be used as variable identifications. 


Table 4-2: Variable names and order numbers 


Parameter Symbolic name Order number 
Fractional Coordinates X,Y,Z 1- 3 
Displacement Tensor Components 
2nd order Uy U11, U22, U33, U12, U13, U23 4 - 9 
3rd order Uii U111, U222, U333, U112, U221, U113, | 10- 19 
U331, U223, U332, U123 
4th order Uii U1111, U2222, U3333, Ul1112, U2221, | 10- 34 
U1113, U3331, U2223, U3332, U1122, 
U1133, U2233, U1123, U2213, U3312 
Multipole Populations 
Monopoles M1, M2 35 - 36 
Dipoles D1+, D1-, DO 37 - 39 
Quadrupoles QO, Q1-*, Q1-, Q2+, Q2- 40 - 44 
Octupoles OO, Ol+, O1-, O2*, O2-, 03+, O3- 45 - 51 
Hexadecapoles HO, H1+, H1-, H2+, H2-, H3+, H3-, H4+, H4- 52 - 60 
Radial Screening 
x,k' (Il) KS, KO, K1, K2, K3, K4 61 - 66 
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Isotropic and Anisotropic | EX11,EX22,EX33,EX12,EX13, EX23, RHOEX | 67 - 73 
Extinction 

Overall U OTP 74 

Scale Factor SC 75 


4.5 Files used and created by XDLSM 


Input: 
Output: 


Optional output: 


xd.mas, xd.inp, xd.hkl, xd.bnk * 
xd lsm.out, xd.res 


xd.fou, xd.der, xd.mat, xd.cov 


4.6 Input instructions for XDLSM 


The next section describes those commands which are interpreted by the program. All of these 
instructions must be placed between the MODULE *XDLSM and the END XDLSM lines in the 


xd.mas file. 


4.6.1 Control instructions 


4.6.1.1 SELECT 


SELECT (*)model m1 m2 m3 m4 based on (f|f^2) (*)test 
SELECT cycle cycles dampk dampk cmin cmin cmas cmax eigcut r 


(*)model m1 m2 m3 m4 This option provides a global control over certain parameters which 
characterize the structure factor formalism applied in the refinement. These parameters are 


shown in Table 4-3 


Table 4-3: The model limits 


m1 static scattering models 


-4 
-3 
-2 
-1 


lmax 


neutron 

core 

conventional, spherical-atom promolecule model with RHF scattering factors 
taken from the International Tables 

neutral, spherical-atom model with HF scatteting factors generated from Slater- 
type wavefunctions [73] 

aspherical-atom model: frozen-core, spherical valence, multipolar deformation 
density up to Imax in the expansion over spherical harmonics [1 1] 


m2 thermal motion models 


-1 


overall-isotropic-harmonic 


0 static 

1 isotropic - harmonic 

2 anisotropic - harmonic 

tmax anharmonic model: Gram-Charlier expansion up to 4th order [75] 
m3 anomalous dispersion 

0 excluded 

1 included 

m4 extinction 

0 excluded 

1 included 
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The values given after the model option are applied for all atoms only as an upper limit. The 
option has only limited applications but can provide an easy way to reduce the complexity of 
the scattering formalism without having to modify all necessary parameters one by one. Note, 
that certain combinations of the control parameters are meaningless which might not be 
recognized by the program. 


based on (f|f^2) The refinement is based on structure factors or on their squares. The data 
in the reflection file xd. hk1 are transformed accordingly. 


(*)test If flagged an input test is performed. This includes calculation and printing of 

. the scattering factor tables, 

. the local coordinate systems, 

. the variable-parameter list, 

. the matrix of constraints, together with the result of its singular value decomposition 

. a file xd scat atom.out is printed for each atom type read in scat table in order to 
check two different calculations of the scattering factors (from the analytical 
expansion and from the wave function databank selected) 


aBRWN eH 


cycle cycles [0] 
20 The number of least squares cycles requested. 

=0 Structure factor calculation. 

<0 Scale factor refinement. 


dampk dampk [1.0]. This is a damping parameter applied to refinement of kappa's. 


cmin cmin [0.6] cmax cmax [1.] Lower and upper limit used as a criteria for printing the 
correlation matrix elements. 


eigcut r [1.e-10] If the solution of the system of normal equations are obtained through 
diagonalization, ris used as a cutoff limit for the singularity test. Eigenvalues are considered 
to be zero and omitted from the calculation of the inverse matrix until the inverse condition 
number is smaller than r: 
min(eigenvalue) / max(eigenvalue) < r 
This test is applied to the eigenvalues of the reduced matrix (derived from the constraints) and 
the conditioned matrix (see Introduction). The same parameter is used as a criteria for 
eliminating linear dependencies among the constraints. (Singular value decomposition of the 
matrix of the constraints.) 


4.6.1.2 SAVE 
SAVE (*)deriv (*)lsqmat (*)cormat 


deriv The structure factor derivatives for each reflection (design matrix) in the last cycle are 
saved in the file xd.der 


Isqmat The least squares matrix and vector in the last cycle are printed to the file xd.mat. 


cormat The variance-covariance matrix is written to the file xd.cov. This file is needed for 
estimating the standard deviations of different properties. The structure and the content of the 
file is given elsewhere in Table 2-4. 


4.6.1.3 SOLVE 
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SOLVE [*]inv (*)diag [*]cond 


The solution of the least squares normal equation can be obtained through inversion or 
diagonalization. 


inv For inversion the Gauss-Jordan method is implemented. The program will automatically 
switch to diagonalization if the matrix is found ill-conditioned (or singular) during the 
inversion in the first cycle. The matrix inversion is the default option. 


diag For the calculation of the eigenvalues and eigenvectors, the Jacobi algorithm is used 
which is considerably more time-consuming than other 'modern' diagonalization methods but 
it is steady and works reliably even with an unconditioned least square matrix. If an 
eigenvalue fails the test based on the condition number (see eigcut), the corresponding 
eigenvector is printed. 


cond The normal equation matrix is conditioned via the transformation 4.12. It is done on 
request (if flagged), irrespective of the method of solution selected. 


4.6.1.4 SKIP 


SKIP (*)obs obsmin obsmax [*]sigobs sigmin sigmax (*)sinthl snimin snlmax 


The SKIP instruction defines criteria for rejecting observations from the refinement (not from 
the structure factor calculation). To make a criterion active the corresponding option should 
be flagged. If more than one are activated the 'AND' logic is applied. The available options 
are: 


obsmin [0.0, 1.0e10] observations for which obsmax > obs > obsmin will be used in the 
refinement 

sigobs [3.0, 1.0e10] observations for which sigmax*obs > obs > sigmin*obs will be included 
sinthl [0.0, 2.0] lower and upper limit in sin0/A 


4.6.1.5 PRINT 


PRINT (*)sinthl snimax snlmax (*)obs obsmin obsmax (*)delta dmin dmax [*]del% min% max% 
(*)exten extmin extmax (*)abssc 


The PRINT instruction defines criterion for printing observations. After the last cycle the 
following quantities can be printed: 
no h k l sinthl scgrp obs calc delta (del% | flag) exten code 


where 
no the order number of a reflection 
hkl reciprocal-lattice components of the scattering vector 
sinthl sin(0)/ 
scgrp scale group number 
obs Fo or Fo 
calc Fe or Fe 
delta Fo — Fcor F?o or Fc 
flag a flag based on f = |100 * (obs — calc) / obs | It is a four character long string as 
follows: 
i , for O<f<5 
cig ¢ for 5<f< 10 
wen oe for IO <f<15 
Mee cm for 15 < f< 20 
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ee for 20 «f « 25 


7??? for 25«f« 30 
del% fis printed instaed of a flag 
exten the extinction correction in percentage 
code O included in the refinement 


-1 rejected based on criterion obs 

-2 rejected based on criterion sigobs 

-4 rejected based on criterion sinthl 

-3 rejected based on criteria obs and sigobs 

-5 rejected based on criteria obs and sinthl 

-6 rejected based on criteria sigobs and sinthl 

-7 rejected based on criteria obs and sigobs and sinthl 
The options, if flagged, serve as a lower and an upper limit applied for printing. Again, the 
'AND' logic applies. 


(*)sinthl snimin snlmax [O 2] 
(*)obs obsmin obsmax [O 10] 
(*)delta dmin dmax [-50 50] 
(*)del% min% max% [80 100] 
(*Jexten extmin extmax [80 100] 


(*)absse_ if flagged the observations are printed on an absolute scale 


4.6.2 The SCAT table 


The SCAT table provides a compact format for defining different scattering factors or 
modifying the entries in the databank file xd. bnk_*. In contrast with previous versions of 
the program, the SCAT table now includes all atomic orbitals. If an old xd.mas file is used, 
this table must be modified otherwise it will not be read correctly. The heading of the SCAT 
table is: 


SCAT core sphv defv 1s 2s 3s 4s 2p 3p 4p 3d 4d 4f 5s 5p 6s 6p 5d 7s 6d 5f Af ' Af" nsctl 


core core scattering factor 

sphv spherical valence scattering factor 

defv scattering factors due to valence deformation functions 
1s 2s 3s... occupations of HF atomic orbitals 

Af ' real part of anomalous dispersion correction 

Af" imaginary part of anomalous dispersion correction 
nsctl neutron scattering length 


This SCAT line has to be followed by as many input lines or subsegments as atom types are 
present in the unit cell. Each row should begin with the element name that must be identical 
to one of the atom types stored in xd. bnk_* (see element naming convention in section 2.5). 
If the element name is the only string in the input line, the data on the corresponding segment 
of the databank file will be used to create the scattering factors. The databank file can be 
extended by introducing new segments assigned to dummy atom names. In this way 
considerable freedom is provided for designing scattering factors from atomic wavefunctions 
expanded over Slater-type basis functions. All the entries indicated above have default 
assignements. To change the default assignement of a particular entry all preceding entries in 
the list have to be given. For example, to change the default values for the anomalous 
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dispersion corrections (Af and Af") all three types of scattering factors as well as the 
occupations have to be input. 


For the scattering factors the following options are available: 


core [chfw|  rdtb 
sphv [chfw]  rdtb  rhft 
defv chfw rdtb  [cszd| rdsd 


4.6.2.1 chfw - Clementi’s Hartree-Fock Wavefunction 


This is the default option for the core and sphv scattering factors and it means that the Slater- 
type atomic orbitals stored on the xd.bnk * file are used. The user has the freedom to 
decide what to consider core and what valence density. This is done by specifying the orbital 
occupations, which have to be positive or negative integers for core or valence orbitals 
respectively. If they are omitted, the default configuration in xd.bnk * is taken. The order of 
the orbitals is given in the heading of the SCAT table. For example, the default configuration 
of the ground state carbon atom is (1s?), (2s2,2p?) and the corresponding line in the input 
table is: 


C chfw chfw cszd 2 -2 0 0-2 


In this case 2(jo(1s1s) and (2(jo(2s2s) + 2(jo2p2p))/4 is calculated, respectively, for the core 
and the spherical valence scattering factors. Note, that the sphv scattering factor is 
normalized, but not the core. 


A 'frozen' spherical atom (only core or spherical atom scattering) could be defined as 


C chfw chfw cszd 2 2 0 0 2 


while that of with radial screening (only valence or spherical atom scattering) 


C chfw chfw cszd -2 -2 0 0 -2 


Another application of the orbital occupations is to form spherical valence scattering factors 
corresponding to an assumed hybridization. For example, one can 'generate' an sp? type 
carbon atom with the following input 


C chfw chfw cszd 2-1 0 0 -3 


which assigns ((jo)(2s2s) + 3(jo(2p2p))/4 to the spherical valence scattering factors. Since more 
than one sets of scattering factors can be generated from the same wavefunction, the multiple 
use of an element name is allowed. 


4.6.2.2 rdtb - Read table 


This option is available for all three types of scattering factors. It indicates that the 
corresponding scattering factor table is to be read from the master file. For an unknown 
element (not stored in the xd.bnk * databank file) the rdtb option must be specified. The 
input should consist of ngrd values (8 entries/lines) of the function taken at an equidistant 
grid of sin0/X. with a step size of grd. ngrd and grd are parameters with default values of 40 
and of 0.05, respectively, in the present version of XDLSM (See Table 4.1). The first grid point 
must be zero. The default setup requires the table to be given up to 1.95 in sin0/X. The 
parameters ngrd and grd should be adjusted to the wavelength of the radiation used for the 
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data collection. The scattering factor at an arbitrary scattering angle is interpolated and the 
derivatives with respect to the expansion-contraction parameters are numerically obtained. 
Accurate evaluation require a considerably fine grid size (not exceeding 0.06 A-}). 


Example: 
C RDTB RDTB CSZD 
2.00000 1.99642 1.98575 1.96816 1.94394 1.91349 1.87726 1.83581 
1.78973 1.73965 1.68621 1.63006 1.57183 1.51212 1.45148 1.39046 
1.32950 1.26904 1.20944 1.15100 1.09400 1.03863 0.98506 0.93343 
0.88381 0.83628 0.79085 0.74754 0.70632 0.66717 0.63004 0.59488 
0.56163 0.53021 0.50055 0.47258 0.44621 0.42137 0.39798 0.37597 
1.00000 0.93697 0.77692 0.58120 0.40061 0.25845 0.15714 0.08962 
0.04686 0.02103 0.00626 -0.00155 -0.00512 -0.00622 -0.00596 -0.00502 
-0.00381 -0.00256 -0.00140 -0.00037 0.00048 0.00118 0.00173 0.00216 
0.00247 0.00269 0.00283 0.00291 0.00294 0.00294 0.00291 0.00285 
0.00278 0.00269 0.00260 0.00250 0.00240 0.00230 0.00220 0.00210 


4.6.2.3 cszd, rdsd - Single-zeta density parameters for defv 


By default (cszd), the radial functions of the valence deformation density are of single Slater- 
type. The parameters of the radial functions (n(), &()) are obtained from the corresponding 
single- wavefunctions of Clementi & Roetti stored also in xd.bnk_* files. In previous 
versions of XD, the option CSZD in the SCAT table computed the exponents for the radial 
deformation functions by simply averaging the valence exponents of the 'best' single-& orbitals 
(Clementi and Raimondi [63]) of the default configuration. 


The new version of the program, instead, computes é’s by weighting the orbitals by their 
occupation. For noble gases and closed shell ions, & is computed: 


e from the (weighted) exponents of the outermost shell of the core for noble gases and 
anions (e.g. the 2s and 2p orbitals for F-, Ne etc.) 

e from the exponents of the first empty orbital(s) for closed-shell cations (3s for Na*, Mg?* 
etc.; 3s and 3p for AI?*, Si^* etc.; 4s for K*, Ca2*; 3d for Sc?*, Ti^* etc.). 


The closed-shell configurations recognized are those of the noble gases (thus, 2, 10, 18, 36, 54 
electrons), and those of some cations of the 4'^ and 5'^ row (like Cu*, Ga?*, Sb*5*), which may 
have 28 or 46 electrons (single-§ exponents considered are those of 3d and 4d orbitals, 
respectively). All other configurations missing the valence electrons are not recognized by the 
program, which then stops. 


The orbitals used to compute the average are directly linked to the SCAT table configuration. 
Thus, if the user modifies the number or the type of valence electrons (at his own risk!) in the 
SCAT table, then Z will change. Note that in the previous versions of XD, the SCAT table was 
intended to modify just the SPHV monopole, evaluated by the multi-exponent HF wave 
functions (Clementi and Roetti). 


Warning messages will appear in the output if the configuration chosen is unusual or dangerous 
and severe stops are applied if the requested orbitals are not stored for a given atom. 


The default values can be modified by using the option rdsd which makes it possible to input 
all n() and & (J in atomic units: 


C chfw chfw rdsd 
n(0) zeta(0) n(1) zeta(1) n(2) zeta(2) n(3) zeta(3) n(4) zeta(4) 
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4.6.2.4 The chfw option for defv 


An advanced feature of XDLSM is to allow for the use of HF radial functions for the 
deformation density. Such application needs each (J) to be attributed to a proper combination 
of orbital products. The Table given in the Introduction (Section 1.9) summarizes the different 
order of Fourier-Bessel transforms that occur for the different orbital products. An orbital 
product is given by the names of the comprising orbitals in brackets: (2s2s), (2p2p), (3d3d), 
etc. If more than one product contributes to (Ji) they should be connected by the plus '*' sign. 
The character string composed in such a way must be continuous: (2s2s)*(2p2p) ... etc. A 
product or a sum of products contributing to (J) have to be specified for each I. Not all radial 
densities can be constructed from a given wavefunction. To make a complete set, all options 
available for defv can be combined, as explained below. If neither cszd nor rdsd is specified 
for sphv the program expects additional input lines with one of the following contents: 


l [cszd] 

l chfw conf 

l rdsd n(l) zeta(l) 
l rdtb 


For each lan option can be selected which determines any further input. If no line is given for 
certain l values the default (cszd) applies. For chfw the configuration (conj) is to be given in 
terms of orbital products or their sum. For rdsd the parameters of the radial functions are 
needed. After rdtb a scattering factor table is to be read as described above. 


Example: 

C chfw chfw chfw 2 -2 00-2 

0 chfw (2s2p)+(2p2p) 

1 chfw (2s2p) 

2 chfw (2p2p) 

3 rdsd 3 3.71 

4 rdtb 

0.00000 5.99918 4.95113 3.64245 2.42954 1.49816 0.87092 0.48586 
0.26409 0.14158 0.07557 0.04045 0.02182 0.01190 0.00658 0.00370 
0.00211 0.00122 0.00072 0.00043 0.00026 0.00016 0.00010 0.00006 
0.00004 0.00003 0.00002 0.00001 0.00001 0.00001 0.00000 0.00000 
0.00000 0.00000 0.00000 0.00000 0.00000 0.00000 0.00000 0.00000 


In the above example (Jo) is the sum of the O-th order transforms of ss and pp type radial 
functions and irrespective of the normalization it is equivalent to sphv. The (Ji) and (Jo) 
functions are related to sp and pp type orbital products, respectively. The scattering factor for 
octupoles is created from single-G radial functions while that for hexadecapoles is read in. 


4.6.2.5 rhft - Relativistic Hartree-Fock scattering factors for sphv 


If a spherical atom model is selected, the RHF scattering factors, as given in the International 
Tables [82] or in refs. [66, 67] in the form of an expansion over Gaussian functions, can also 
be used. The rhft option for hydrogen selects the contracted scattering factors of Stewart, 
Davidson & Simpson [81]. 


4.6.2.6 Current Limitations 


The calculation of the static electron density and of electronic properties requires the 
evaluation of the radial functions within an accuracy that can hardly be reached by numerical 
inverse Fourier transform of the scattering factors. The default choice, the use of Slater-type 
HF wavefunctions (chfw, cszd or rdsd), means analytical representation of both direct and 
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reciprocal space functions. For a refinement to be consistent with the property calculation, it 
must be based on the wavefunctions stored in xd.bnk_*. The corresponding scattering 
factors are certainly not the best available ones and can slightly differ from those found in the 
International Tables. Relativistic effects are important only for heavier elements - this can be 
seen by comparing the total chfw spherical scattering factors with those based on relativistic 
numerical wavefunctions. Efforts are being made to eliminate this limitation. 


4.6.2.7 Anomalous scattering 


delf delf” 
The defaults correspond to Mo radiation. 


4.6.2.8 Neutron Scattering Length 


nsctl 
The last entry of a SCAT line is the neutron scattering length. 


4.6.3 The ATOM table 


For each atom included in the structure factor calculation the following entries are to be 
given: 


ATOM atom0 ax1 atom1 atom2 ax2 r/ltp tbl kap Imx sitesym chemcon 
4.6.3.1 Atom name conventions 


The atom name is a continuous string of up to 8 characters, starting with a correct, case 
sensitive chemical symbol (e.g. ‘Na’ and not NA’) used in the SCAT table and followed by 
further characters enclosed in parentheses (). Legal atom names are: 


Cu(3) Ti3+(1la) 
4.6.3.2 The local coordinate system 


The entries in the first seven columns define the local coordinate systems. atom, atomO, atom1 
and atom2 are atom names from the ATOM table list. ax1 and ax2 stand for different axis 
assignments, each being either x or y or z. The first axis (ax1) is given by the internuclear 
vector from atom to atomO (vi). This together with the second vector from atom1 to atom2 (v2) 
define the (ax1,ax2) plane. The third vector (v3) is taken perpendicular to this plane. 

vi = (fo - r) V2 = (r2 - rı) V3 = V1 X Vo 


Finally, an orthonormal vector triplet (€ax1, €ax2, €ax3) is formed which can be chosen to be 
either right (R) or left (L) handed 


eai = vi/ |v] eao = (V3 x vi)/ | (vs x vy)] €ax3 = V3/ | v3] 


where r, ro, rı and r2 are the position vectors of atom, atomO, atom1 and atom2, respectively 
(MOLLY). 


4.6.3.3 tp - the Order of the Atomic Displacement Tensor 
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0 no thermal parameter is applied (static scattering model) 
1 isotropic U 

[2] anisotropic Uy 

3 anharmonic 34 order Gram-Charlier expansion U ix 

4 anharmonic 4*^ order Gram-Charlier expansion Uii 


If this value differs from that in the input file the thermal displacement parameters will be 
converted: 


xd.mas xd.inp 
1 2 from anisotropic to isotropic 
2 1 from isotropic to anisotropic 


4.6.3.4 tbl - The Core Scattering Table 


Refers to the core scattering table. It is the order number of the corresponding element given 
in the SCAT table. 


4.6.3.5 kap - the Kappa Set 


Defines the kappa set applied to the valence radial functions. If a new set is introduced or the 
previous arrangement is redefined the corresponding changes must also be made in the 
parameter file xd.inp and/or to the KEY table. If the values in the parameter file are not 
changed the refinement will start from the default value (1) for all kappa sets. 


4.6.3.6 Imx - the maximal level of multipole expansion 


0 Monopoles (sphv and defy) 

1 Dipoles (default for hydrogen atoms) 
2 Quadrupoles 

3 Octupoles 

4 


Hexadecapoles (default for non-hydrogen atoms) 

4.6.3.7 sitesym [no] 

The point group number of the atomic site symmetry. It is not used in the present version. 
4.6.3.8 chemcon 


Refers to the atom to which the valence deformation density of the atom considered is 
constrained. If the same set of multipole populations are to be shared by two or more atoms, the 
definition of the local coordinate systems of the corresponding atoms must be consistent. 


4.6.3.9 Dummy Atoms 


To enable one to define a local system of arbitrary orientation, dummy atoms can be used. 
These are to be specified after the atom list but within the atom table by giving a name, 
composed of the string 'DUM' and a number, followed by the three coordinates (free format) in 
the crystal system. 


Example: 
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ATOM atom0 axl atoml atom2 ax2 r/l tp tbl kap lmx sitesym chemcon 
O(1) 0(2) X O(1) DUMO Y R 2 1 1 4 NO 

0(2) O(1) X O(1) DUM1 Y R 2 1 1 4 NO 0(1) 
DUMO 0. 0. 0. 

DUM1 -0.4800 0.5335 0.0973 

END ATOM 


4.6.4 GROUPn 


GROUPn atom(1)... withn>1 


The GROUP command selects a set of atoms to be considered as a unit for special 
applications. Such applications available presently are the electroneutrality and rigid-body, 
rigid-link type constraints see (KEEP instruction). The first group (GROUP 1) is, by definition 
composed of the atoms in the asymmetric unit. An atom is allowed to be part of more than one 
group. The atom list defining a group can be on more than one input line, but each line must 
start with the same GROUPn command. 


4.6.5 KEEP 


The KEEP instruction simplifies the application of certain constraints. 
KEEP kappa set(1) ... 


For each set defined «', the expansion-contraction parameter of defv, is kept the same for all l. 
This is a default constraint that is suggested to apply, at least in the initial stages of a 
refinement. 


Important! The fit is always very sensitive to x’, even if a single parameter is refined 
for all | values. The results of «' refinement should always be critically examined 
and compared to those obtained with «'= 1. For HF radial functions, the chance of 
obtaining convergence with reliable estimates of different «1 parameters is expected 
to be better than for single Slater orbitals. A separate «1 refinement is worth trying 
for transition metals. 


KEEP charge [group1] groupn ... 

Each group defined by the GROUP command can be treated as a closed unit for which the 
total charge is kept fixed during the refinement. The total charge of the group is given by the 
sum of the starting monopole populations of the comprising atoms. The user is free to define 
any subset of atoms (even having common elements) which are excluded from charge transfer. 
Each group fixed in this way adds one new equation to the system of constraints. A zero 
singular value of the matrix of constraints means inadequate grouping and the redundancy 
found will be rejected. 


KEEP rigid [group1] groupn ... 

Each group defined by the GROUP command is kept rigid in the sense that the shifts in the 
ADP's of the atoms comprising the group are constrained to satisfy Hirshfeld's rigidity 
postulate. To make such a restriction work, all ADP's of all atoms in the group must be 
refined. The equation of constraint is set for all internuclear connections in the group and the 
linearly dependent equations are eliminated leading to the necessary reduction in the number 
of restrictions. 
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KEEP DIST atom1 atom2 

KEEP ANGLE atom1 atom2 atom3 
KEEP TORS atom1 atom2 atom3 atom4 
KEEP SHAPE [group1] groupn 

KEEP INTRA [group1] groupn 


RESET BOND atom H-atom distance (A) 

The distance between an H-atom and its bonded atom is reset to the designated (usually 
neutron determined) distance at the end of each cycle. The H-atom must be listed second, and 
its coordinates should not be refined. 


4.6.6 The Weighting Scheme 


WEIGHT abcdef 


a [0.0] b [0.0] c [0.0] d [0.0] e [0.0] £ [1/3] 
The weighting scheme implemented in SHELXL for refinement on F? is used: 


w, = q/|s2 +(ap} +bp+d + e*sin@)| 
where 


s, = sigma(F; ) 
PESER pepe 


q=1 ifc-0 
orq- exp(c[sin(9) /AT ) ifc>O 
or q =1—exp(c{sin@)/a}’) Pes 


The weight for refinement on F (w1) is calculated as follows: 
w, = F * sqrt(w,) + sqrt (F? * w, + sqrt(w,))? 


Important! This general weighting scheme has been developed for refinement 
based on conventional, spherical atom model and thus may not be adequate for 
multipole refinement. For the latter case a = -2 is suggested leading to 
w, =1/s} and w, =1/s? 
The goodness of fit with w, =1/ 5; is also calculated. With a= -1 a unit weight can be applied. 
The parameters of the weighting form cannot be refined. 


4.6.7 DMSDA 


DMSDA rmin rmax 
rmin [1.1] rmax [1.8] 


The difference of the projections of the mean square amplitude tensors of two atoms to the 
corresponding internuclear vector are calculated if the interatomic distance falls in the range 
given by rmin and rmax. As discussed in the Introduction, Hirshfeld's rigid-bond test [74] can 
help to reveal model inadequacies and should always be a part of a careful analysis. The 
positional coordinates and the anisotropic displacement parameters in an orthogonal system 
are also printed. 
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4.6.8 Extinction refinement 
This instruction line for extinction correction appears in xd.mas: 
EXTCN (*)iso (*)aniso (*)type 1 (*)type 2 (*)type 3 (*)distr g (*)distr 1 (*)msc O (*)msc_1 


By default the EXTCN command appears as a comment in Xd.mas. To get it activated the 
exclamation mark (!) has to be removed. The extinction correction is based on the models 
proposed by Becker and Coppens [83,84,85], which can be summarized as follows: 


4.6.8.1 Isotropic extinction (*iso, default): 


extinction type: 

e type 1 (*type_1, default): mosaic spread, the g' coefficient is refined (variable EXT11); 

e type 2 (*type 2): particle size, the p coefficient is refined (variable EXT11); 

e type 3 ("type 3, *type g is also accepted): generalized type, mosaic spread and particle 
size (g' and p) are simultaneously refined (variables EXT11 and EXT22, respectively); 


mosaic spread distribution (active only for type 1 and type. 3): 
e Gaussian (*distr g, default): a Gaussian distribution is assumed; 
e Lorentzian (*distr 1l) : a Lorentzian distribution is assumed; 


4.6.8.2 Anisotropic (*aniso): 


extinction type: 

e type 1 (*type_1, default): mosaic spread, the Z tensor is refined (variables EXT11-EXT23) 
(g(D)=(DtZD)!/2; D is a unit vector perpendicular to the diffraction plane); 

e type 2 (*type_2): particle size, the W tensor is refined (variables EXT11-EXT23) 
(p(N)7 à (N*tWN) !/2; N isa unit vector perpendicular to the incident beam); 

e type 3 (*type 3, *type g is also accepted): generalized type (mosaic spread and particle 
size), D tensor and p simultaneously refined (variables EXT11-EXT23 for D; variable 
RHOEX for p); 


mosaic spread distribution (active only for type 1 and type 3): 
e Gaussian (*distr g, default): a Gaussian distribution is assumed; 
e Lorentzian (*distr_l) : a Lorentzian distribution is assumed; 


mosaic orientation (active only for type_1 and type_3): 

e Coppens and Hamilton (*msc 0): the distribution proposed by Coppens and Hamilton [86]; 

e Thorney and Nelmes (*msc 1, default): the distribution proposed by Thorney and Nelmes 
[87]. In this case the Y tensor is refined instead of Z (g(D)=(DtYD)-!/2). 


Given the expression for tensors W, Y, and Z, a switch from isotropic to anisotropic correction 
requires the following variables in xd. inp: 
(1) g to Z: 
EXT11 = EXT22 = EXT33 = (g'i))? 
EXT12 = EXT13 = EXT23 = 0.0 
(2) g to Y: 
EXT11 = EXT22 = EXT33 = 1/('iso)? 
EXT12 = EXT13 = EXT23 = 0.0 
(3) p to W: 
EXT11 = EXT22 = EXT33 = 1/( p iso)? 
EXT12 = EXT13 = EXT23 = 0.0 
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If a non-positive definite tensor (W, Y or Z) is derived, the program stops (if the 'resetting' of 
the tensor fails). 


In the output file xd_lsm.out, the following parameters are reported: 

e for isotropic extinction: mosaic spread, n (n+1/g', unit is seconds) and domain size r (r = 
g10-^, unit is centimeters) are given, as derived from the refined g' and/or p 

e for anisotropic extinction: Principal axes of mosaic spread n(D) (if *type 1 or *type 3) or 
domain size r(N) (*type 2) distribution are given; the corresponding 'equivalent' and r 
scalars are computed (or the refined r is printed if *type 3 is applied). 


For an extinction refinement, the absorption weighted path length (tbar) has to be stored in 
xd.hkl. An anisotropic extinction refinement needs six additional entries for each 
observation: 

1-3: the three components of vector D 

4-6: the three components of vector N 


4.6.9 FOUR - Structure factor calculation 


FOUR fmod1 m1.1 m1.2 m1.3 m1.4 fmod2 m2.1 m2.2 m2.3 m2.4 


The FOUR command ensures that a Fourier file xd. fou is written after the last cycle. 
Structure factors based on two models but on the same set of parameters are calculated and 
saved together with Foy, and the phases. The latter quantities are corrected for anomalous 
dispersion as follows. 


0 _ * obs*-^calc 0 
As, Ei (A cata A vac) 
cala 
FB 
0 obs ™ calc 0 
Bors = (Beate Brac) 


0 0 42 0 Q2 
Fos z JO8,) + (Bors) 
where A and B are the real and imaginary parts of the structure factor F and a zero 
superscript (°) designate terms without anomalous dispersion correction. The standard 
deviation of Fob? is estimated as 


) Js. A vate p + (B we B calc y 
F? F 


obs” calc 


o (r: )=o (Fn 


obs 


The phases are based on the model applied in the refinement (see instruction MODEL). Each 
of the structure factor model (fmod1, fmod2) is specified with four integers, in the same way 
as described above. The combination of fobs, fmod1 and fmod2 makes it possible to generate 
six different Fourier maps (see XDFOUR). By default, the FOUR command appears as a 
comment line in xd.mas. In the example below, a Fourier file is created with two calculated 
structure factors. The first one based on a multipole model (Imax=4), the second one on a 
neutral spherical atom model (Imax--1). Both are free of anomalous dispersion and extinction. 


FOUR fmod14200 fmod2 -1 2 0 0 
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4.6.10 CON - General linear constraint 


CON al varl a2 var2 a3 var3 ... =c 


The CON instruction defines a linear combination among a set of variables used as a 
constraint. A list of the coefficients (a1,a2,a3,...) and variable-symbols (var1, var2, var3,...) are 
to be given terminated by the equal sign ('='), which is followed by the last entry (c) to define 
the right side of the equation. The coefficients and the variable names are read as numeric 
and character fields, respectively. A variable name is composed from the corresponding 
symbol described before (Table 4.2) and from a number (if needed) referring to the atom 
(kappa set or scale group) to which the variable is assigned. The two components of the name 
are divided by the slash ('/). The resulting character string must not contain blanks. The 
following are correct variable names: 


X/1, U12/12, U333/1, M1/2, H4+/11, KS/3, K2/2, SC/1, EX12 


The list of coefficients and variable names must be terminated by the equal sign. More than 
one line can be input with the same CON command. A new line is read until the equal sign is 
found. Note, that here, what is meant by the term 'variable' is actually, the shift in that 
variable and not the variable itself. 


Important! The program does not check if a constraint is meaningful. Redundancies (linear 
dependencies between the constraints) are recognized, reported and eliminated. 


Applications of practical importance are the constraints due to crystallographic site 
symmetries. In the present version of XDLSM these constraints are not treated automatically. 
The violation of a symmetry restriction leads to singular least squares matrix. If the solution 
is obtained via diagonalization, the singularity can be eliminated (the corresponding constraint 
is introduced). Although this procedure might work in most of the cases, it is not advisable to 
let a numerical procedure handle the symmetry. After several cycles, roundoff errors are 
likely to break the symmetry in the shifts. Symmetry restrictions can easily be formulated. 
Either the variable itself or the combination of two variables are fixed. The former does not 
need extra CON card since the corresponding variable is simply not refined (see KEY table). 


Example: 
Formula KHF2, space group /4/ mcm (No. 140). The three atoms in the asymmetric unit occupy 
the following special positions: 


No. atom Wyckoff letter x Zz 
1 K a 0 0 1/4 
2 F h x x+1/2 0 
3 H d 0 1/2 0 


The corresponding CON cards are: 


CON 1 x/2 -1 y/2 = -0.5 
CON 1 u11/1 -1 u22/1 = 

CON 1 u11/2 -1 u22/2 = 0 
CON 1 u11/3 -1 u22/3 = 0 


Another example of practical importance is the use of Kubic harmonics. Let suppose that 
atom 1 is at a cubic site. The symmetrized spherical harmonics to be applied is composed as 
a linear combination of hexadecapoles, HO and H4+. The corresponding constraint is 

CON 1 H4+/1 -0.74048 HO/1 = 0 


49 


Chapter 4 - XDLSM - Least Squares Program for Multipole Refinement 


Site symmetry restrictions on thermal tensor elements and on spherical harmonics are given 
in reference [88]. 


4.6.11 The KEY table 


KEY xyz -U2- ----U3---- ------ U4------- M- -D- -Q- -0- ----H---- 


This input segment is to specify which parameter is to be refined and which is not. It is done 
by giving the KEY-integer array with values O or 1 for a fixed or for a refined parameter, 
respectively. The order of the parameters is as defined before in Table 4-2. First the atomic 
parameters (x,y,z, Ui, Ui, Ujk, Pim) have to be given for all of the atoms included in the 
structure model. These are followed by the 'shared' (x, x") and by the 'global' parameters 
(extinction, overall thermal parameter, scale factors). The heading of the KEY table helps in 
keeping account of the variables. The different abbreviations are as follows: 


XyZ 3 positional coordinates 

Un nth order displacement amplitude tensor components. There are 6, 10 and 15 
for n-2,3 and 4, respectively 

M 2 monopole populations; the first for sphv and the second for defv 

D 3 dipole 

Q 5 quadrupole 

O 7 octupole 

H 9 hexadecapole populations 

KAPPA 1 for sphv and 5 for defv (x^, =0,lmx). It should be given for each KAPPA set 
defined in the ATOM table 

EXTCN 1, 6 or 7 extinction parameters 

OVTHP 1 overall thermal parameter 

SCALE NQ scale factors 


As many atom entries are to be given as in the atom table. The atom names used here have to 
be identical to those in the atom table otherwise the program terminates with error message. 
Similarly, the number of kappa entries must be equal to the maximal number used in the 
atom table to refer to kappa sets (see 4.6.3.5) If the command KEEP kappa is applied to a set 
then all but the first kappa-integers for the corresponding devf (k^, (1,4) should be zero. The 
number of key integers for the scale factors should be less than or equal to the number given 
in xd. inp (NQ). The key integers are interpreted according to the maximal level of GC and 
multipole expansion defined in the atom table for each atom by the parameters tp and Imx, 
respectively. 


Important! The multipole populations of the atoms involved in 'chemical constraints' (those 
which are constrained) must be fixed. The populations of that atom to which the others are 
constrained are 'free' variables. Parameters involved in any other constraint must be made 
variables. An example is : 


KEY xyz --U2-- ---- U3---- ------ U4------- M- -D- --Q-- ---0--- ----H---- 
O(1) 111 111111 0000000000 000000000000000 10 110 10011 0110011 100110011 


KAPPA 110000 
EXTCN 0000000 


OVTHP 0 
SCALE 111 
END KEY ---------- 


50 


Chapter 4 - XDLSM - Least Squares Program for Multipole Refinement 


Table 4-4: Index Picking Rules of Site-Symmetric Spherical Harmonics [89] 


Symmetry Choice of coordinate axes Indices of symmetric Ymp (A, u are integers) 
1 any all (/,m,+) 
1 any (2A,m, +) 
2 2 || z (7,2u, +) 
m mlz (Ll-2u, +) 
2/m 2\|z,mla (24.21, +) 
222 2 Z, 2 Il y, (2 | x) (24,2u,+), (2A+1,2uU,-) 
mm2 2 || z, mL y, (m Lx) (7,2u,+) 
mmm mlzmlymlx (24.21 +) 
4 4 || z (L45,X) 
4 4 lz (20,4u, +), (2A+1,4+2,+) 
4/m 4||z,m Lz (2à,4u, +) 
422 4 Z, 2 Il y, (2 | x) (2à,4u,+), (2à+1,4u,—) 
4mm 4||z, m.L y, (m Lx) (7,4u,+) 
42m 4 |z 2|x (m xy > yx) (21,4,+),(2A+1,4u+2,—) 
(20,4u,+),(2A+1,4u+2,+) 


m .L y, (22 xyz — yxz) 


4/mmm 4 |z, m Lz, (m L x) (m^ xy > yx) (21,4u,+) 
3 3 || z (7,3 u,+) 
3 3 | Z (22,34) 
32 3 Z, 2 I y, (2A,3p,+),(2A+1,3p,-) 
2 || x Gut2j,3u,+),(3u+27+1,3u,-) 
3m 3 Zz, M l y (L31,*) 
max (L61,*),(161:7-3,—) 
3m 3|zmly (2,31,*) 
mtx (2,6u,+),(20,641+3,—-) 
6 6 || z (L6u,+) 
6 6 lz- G | z m.Lz) (20, 6p,+),(2A+1 ,611+3,+) 
6/m 6 || Z, 2 lly, 2 || x) (22,6u,4) 
622 6 Z,mty, (2 | x), mL X, (2 Il y) (22,6u, )(2A 1,61,-) 
6mm 6 || z, m.L y, (mL x) (7,6u,+) 
6m2 6 |z,m Ly, (2 || x) (22,6u,+),(2A+1,6n+3,+) 
mtx, (2 | y) (2X, 6p, 2X 1,6u 3, ) 
6/mmm 6 || z.m 1 z, m Ly, (m Lx) (2à,6u, +) 
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Chapter 5 


XDGEOM - Geometry Functions, Errors and 
Tables 


5.1 Overview 


This program computes various functions of the atomic coordinates together with errors 
obtained from the variance-covariance matrix. The method is fully described by Busing, 
Martin and Levy [90], and is given in outline below. Errors in the unit cell parameters are 
applied if they are provided in the form of a CELLSD entry in the Master File (see example). 
Torsion angle errors are calculated by the method of Stanford and Waser [91]. An algorithm 
due to Rollett [92] is used to generate space-group symmetry-related atoms automatically, 
where relevant. 


Additionally, CIF (Crystallographic Information File) listings of the functions and atomic 
parameters are produced. The rhoCIF specifications for multipole population coefficients are 
used. Note that in a future release of XD, it is planned to move listings of all refined 
parameters to xd 1sm.cif. 


5.1.1 Mathematical method 


A function lof the n nuclear positions may be defined as 


l= f (Pub Pn) 


and its estimated deviation as 
o (l) = f(u,.u,,...,u,) 
where 
_ al 
| 6p, 


The derivative of a function of several variables is given by 


i 


ol ol ol 
dl = —— dp, + —— dp, +...+ —— d 
8 P: 8 Pa 8 Ip, 


1 2 D, 
so that 


c^()- b» 


i-l 


where ci = o(p). Hence 


o (l= Y Yu, 


i=l j=l 
which is a quadratic form. So the variance of l may be written 


o’*(/)=u'Cu 
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and the matrix C is the variance-covariance matrix. Its diagonal elements are the variance of 
the parameters: 


and its off-diagonal elements are covariances: 
C; =cov(p;, p,) = C;r; 


where rjis a correlation coefficient. 


5.2 Files used and created by XDGEOM 


Input: xd.mas, xd.res, xd.cov 
Output: xd geo.cif, xd.tex, xd geo.out 


5.3 Input instructions for XDGEOM 


5.3.1 SELECT 


SELECT (*)rmin rmin (*)rmax rmax (*)ato (*)bon (*)ang (*)tor (*)loc (*)non 
rmin [0.01] rmax [use radii from databank] 


(*)rmin rmin (*)rmax rmax 

Internuclear separations in À defining bonded atoms, and atoms in van der Waals contact, 
may be given here. Bond and contact distances and angles are calculated according to the 
connectivity so defined. If non is selected, rmin and rmax define the range of van der Waals 
contacts. Distances less than rmin are then taken to be bonding distances. 


Alternatively, the default action is to use the covalent and van der Waals radii from 
xd.bnk * (the chosen system databank file) to define bond and contact distances. In this 
case rmin and rmax are not selected. A special case is the selection of an rmin value of 
exactly zero, in conjuction with non. Then bonds are defined by covalent radii and contacts by 
the selected value of rmax. 


(*Jato 
Generates a list of atomic coordinates, displacement amplitudes, multipole population 
coefficients, and their estimated standard deviations. 


(*)bon 
Generates a list of bond distances and their e.s.d. 


(*)ang 
Generates a list of bond angles and their e.s.d. 


(*)tor 
Generates a list of torsion angles and their e.s.d. 


(*)loc 

Lists the ‘local geometry' at each atom. This is a list of all bonds and angles and their e.s.d. for 
each atom in turn, together with the symmetry operations used to generate the connected 
atoms. 


(*)non 


Generates a list of van der Waals contacts and their e.s.d., with the symmetry operations used 
to generate the contacting atoms. 
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5.4 Example Master File segment for XDGEOM 


TITL HCONH2 Formamide 123K 

CELL 3.6130 9.0570 6.9730 90.000 100.360 90.000 
CELLSD .005 .003 .003 0.0 0.06 0.0 

WAVE 0.71069 

LATT C P 


SYMM 1/2 — X, 1/2 + Y, 1/2— Z 


MODULE XDGEOM 
SELECT *rmin 1.6 *rmax 4.0 *ato *bon *ang *tor *non 
END XDGEOM 
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Chapter 6 


XDPROP - One-Electron Properties based on the 
Multipole Representation of the ED 


6.1 Overview 


XDPROP is a program for analysing a STATIC ED which has been obtained in the form of a 
nuclear-centred multipole expansion. It is based on the earlier programs LSPROP (by Sean 
Howard & Paul Mallinson) and MOLPROP (by Zhengwei Su). XDPROP is under continuous 
development and now contains several new features which are discussed below. 


Many of the features in the static properties package are not new. Existing programs such as 
VALRAY [93] (by Mark Spackman and Bob Stewart), POP (by Brian Craven), LSEXP (by Fred 
Hirshfeld), and MOLLY [68] (by Niels Hansen and Philip Coppens) have the ability to compute 
electrostatic potentials, dipole moments and carry out critical point analyses of the total 
density. For accounts of the state-of-the-art of charge density applications, the reader is 
referred to pertinent literature [94]. 


6.1.1 Abbreviations 


This chapter uses the following notation and abbreviations: p (total electron density); CP 
(Critical Point); Ap (Deformation Density); IAM (Independent Atom Model); V(r) (electrostatic 
potential; v(r (nuclear potential; BP (Bond Path - a line of maximum charge density 
connecting two nuclei); PD charges (electrostatic Potential-Derived charges; E (Electric field); 
EFG (Electric Field Gradient); ST (Slater-Type, as of a radial function); HF (Hartree-Fock); LSQ 
(Least Squares, as of a refinement procedure); ESP (ElectroStatic Potential). 


6.1.2 Units 


XDPROP output is in A, electrons and degrees. Exceptions include the Cr-values (exponents of 
Slater-type radial functions), which are conventionally reported in Bohr!, and multipole 
moments (Debye and Debye-À). 


6.1.3 Files used and created by XDPROP 


Input: xd.mas, xd.res, xd.bnk * 

Optional input: xd.inp (ifxd.res does not exist) 
xd.cov (if errors are to be calculated) 

Output: xd pro.out 

Optional output: Xd property.cps, xd property.grd, xd.pth, 
xd bubble.spf, xd *.dat 


56 


6 XDPROP - One-Electron Properties based on the Multipole Representation of the ED 


6.1.4 Coordinate systems 


Although XDLSM uses local coordinate systems on the pseudoatoms, XDPROP works mostly 
with a single, 'elobal' system of cartesian coordinates r generated from the fractional co- 
ordinates rr in xd.res by the transformation 

r-Mry (Eq. 6.1) 


where M is the matrix [95] 


a bcosy ccos p 
0 bsiny c(cosa — cos cosy )/siny 


0o 0 cl- (cos? a + cos? B —2cosa cos B cosy |" / siny 


This is particularly important in considering dipole and quadrupole moments computed with 
XDPROP, which are computed in this frame. 


6.1.5 Current Limitations 


(a) The calculation of errors on p and -V’p has some severe limitations at the moment, namely: 
(i) only contributions from the multipole populations are currently taken into account (Le. 
not K's or coordinates) (ii) contributions to the error from symmetry-generated atoms are 
not taken into account. 

(b) The potential-derived charge fitting subroutine assumes that the fragment is molecular 
(neutral), so it will give nonsensical results for ions. 

(c) Electric field and electric field gradient calculations are not yet available, although they are 
mentioned in some parts of the manual. 

(d) It is only possible to compute errors on the dipole moment, p, or -V’p if Slater-type radial 
functions have been used for all multipoles. 


6.2 Input Instructions for XDPROP 


The Master file entry for XDPROP should begin with MODULE *XDPROP and be terminated by 
the END XDPROP line. 


6.2.1 MODEL 

MODEL (*)iam (*)multipole 

Only two options are currently available - to use the multipole model (or some modification of 
it) which was applied in the refinement; or to generate the iam (independent atom model) in 


its place. In the latter case, multipole populations (121) are set to zero, monopole populations 
are set to the free atom values, and the x parameters are set to unity. 


6.2.2 APPLY 


APPLY symm is trans tx ty tz (atoms ...| all) 


This command is used to apply a crystallographic symmetry operation to some or all of the 
pseudoatoms in the asymmetric unit. This can be useful if, for example, the asymmetric unit 
does not contain a whole molecule, or if the properties of two or more molecules are to be 
analysed, or for studying intermolecular hydrogen bonding. The symmetry operations are 
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referenced according to the sequence in which they are listed in xd. pro.out. For example, the 
following entry 


APPLY SYMM 3 TRANSLATIONS -2 -1 1 0(1) N(1) C(1) H(1) H(2) H(3) 


applies the third symmetry operation, without an extra lattice translation, to the six atoms 
whose labels are given. If you do not wish to supplement the symmetry operation with an 
additional lattice translation, use TRANSLATIONS 0 0 0. If the symmetry operation is to be 
applied to all atoms in the asymmetric unit, then the keyword all may be used in place of the 
atom labels. More than one line beginning with APPLY may be present. There is a limit of a 
maximum of 7 atoms which may be specified individually on any single APPLY instruction. 


One important point to note is the XDPROP convention for labelling symmetry-generated 
atoms. The symmetry-generated label is of the general form 'X'*sym. op numbert'_'toriginal 
atom label. So for example, an atom generated from O(8) by symmetry operation 6 will have 
the label X6 O(8). This label should be used to refer to the symmetry generated atom in the 
other modules of XDPROP, for example if you want to use such an atom to define a plane, or 


in a CP search. 


6.3.2 GROUP 
GROUP (not) atoms ... 


Whereas APPLY is concerned with expanding the number of pseudoatoms under study, 
GROUP has the opposite effect of selecting a subset of pseudoatoms to be studied. Henceforth 
all sums over pseudoatoms to compute properties will include only those pseudoatoms whose 
atom labels follow the GROUP keyword. Thus an example might be 


GROUP H(1) O(1) H(2) 


If the option not is given, all atoms specified in this GROUP instruction are not part of the 
active group. 


GROUP NOT H(1) O(1) H(2) 


The effect of two or more GROUP instructions is additive. It is possible to reset the active 
group using the keyword ALL. GROUP NOT ALL or GROUP ALL 

There are effectively no lower or upper limits on how many atoms can make up the group. 
This command is useful, for example, when the asymmetric unit contains several moieties, 
and you want to compute the properties of just one of them. The negated form might be useful 
if you want to exclude only a small number of atoms. 


6.2.4 DEFGROUP 
DEFGROUP atoms ... 


This is specialized option concerned only with the deformation density. It will have no effect if 
the active property is not DEFDEN. The purpose of DEFGROUP is to define a subset of atoms 
whose spherical atom density will not be substracted from the total density in creating the 
deformation density. The normal option (the default) is to substract the spherical atom density 
at the nuclear positions for all the atoms in the active group. The synatx is simply (for 
example) 

DEFGROUP Ni(1) Ni(2) 
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6.2.5 SELECT 
SELECT (*) flag ... 
SELECT (keyword value) ... 


So far as is possible, all parameters in XDPROP have some useful default values. However, 
you will doubtless find it necessary to change something, and a number of parameters may be 
altered using this option. More than one card beginning with SELECT may be present, and 
each may contain up to five of the keywords to be described shortly. The first five of these, 
namely local, numdx, check, esd and nocore are just flags, which require no further 
qualifiers. The remaining sub-options correspond to system variables, and the numerical 
value of the variable must follow the keyword. 


Currently, you should not mix flags and options followed by a value on one SELECT line. 
(*)local 


The default is to use a set of multipole populations transformed into a global coordinate 
system for property computation. Selecting the local keyword with an asterisk will instead 
carry out these sums using the original, untransformed populations which came directly from 
the multipole refinement. The results should be identical - this is a diagnostic feature, mainly 
useful for further development of the program. 


(*)numdx 


CP searching a function requires a full set of first and second derivatives with respect to a 
global cartesian coordinate system. Analytic derivatives are available for many functions, and 
for others the derivatives will be computed numerically with finite differences. Placing an 
asterisk by this keyword forces the program to use numerical derivatives for CP searching any 
function, regardless of whether analytic derivatives are available. 


(*)check 


This turns on some extra output from the properties program, including lists of pseudoatom 
parameters and populations. It also checks the atomic density matrices for all atom types 
found in the input file xd. res, by numerical integration. This helps to verify that any new 
wavefunctions added to the file xd.bnk * have been incorporated correctly. These 
normalization integrals can in fact be carried out analytically (a subroutine PMOM in XDPROP 
not called anywhere in this release computes analytic radial moments of the atomic charge 
distributions - the zero moment gives the total charge). 


(*)esd 


The default is not to compute any errors since this needs the variance-covariance matrix file 
xd.cov which, due to its large size, may have been deleted prior to running XDPROP. 
Selecting esd turns on computation of errors, in so far as they are available for different 
properties. Currently errors are only available for: the dipole moment, p (or Ap) and V’p. 

In least squares refinement, the variance in some property A, derived from the Nvars refined 
parameters (Pj, may be estimated from the variance-covariance matrix e [96]: 


N vars OA OA 
(A) =S? sen Manes Eq. 6-2 
o°(A) aE oP (Eq. 6-2) 


where Sis the goodness-of-fit. 


59 


6 XDPROP - One-Electron Properties based on the Multipole Representation of the ED 


(*)nocore 


This means that for the peripheral contributions to the potential, the core electrons and the 
part of nuclear charge equal in magnitude to the number of core electrons are assumed to 
cancel exactly. (Applies to the calculation of the esp only.) 


cpcut dxcut [0.0001] 


This is used in CP searching. A CP is considered to have been located at some point rc if 
| Vflre) | < dxcut. The default value is 0.0001 A, which is generally fine for p, but may be quite 
inappropriate for searching other functions. 


Imax /max 


This is a global maximum [value applied to all pseudoatoms. The default procedure is to 
carry out multipole sums on each pseudoatom to the maximum [-value in place on that atom. 
This will be overridden by the Imax option (an integer variable must be given). Although it is 
not possible to change Imax on individual pseudoatoms using these master file instructions, it 
could of course be achieved by manually editing the xd.res file. 


nstep nstep 


Critical Points (CPs) are located by an iterative procedure - this parameter determines the 
maximum number of steps used in searching for a CP, before the search is abandoned. 


rcut rcut [4.0] 


Local properties f(r) are computed as a sum over pseudoatom contributions: jf[r)-Xjf(r). For 
many properties, notably p, V?p and Ap, it is an excellent approximation to ignore 
contributions of pseudoatoms which lie further than a distance rcut from the point r. The 
default distance of 4.0 À is generally reliable for the afore-mentioned properties, and organic 
compounds. It is not likely to be suitable (i) when ‘large’ atoms are present, e.g. transition 
metals (ii) for V(r) or v(r) (iii) when some pseudoatoms have rather small values of x and/or x'. 
Users are therefore urged to check that the property being computed is converged with respect to 
this parameter. 


scale scale [0.05] 

CP searching involves consecutive steps 5s towards stationary points. The direction of each 
step is determined by the local gradient vector and Hessian matrix for the property concerned. 
The step-length, on the other hand, is controlled by the variable scale, with a default of 0.05 


À. This value works well for searching p, but other (most likely smaller) values should be 
considered in searching more rapidly-changing functions such as V’p. 


dx xstep [0.001] 


The step-length for numerical derivatives (used in CP searching those properties for which 
analytical derivatives are not yet available). 


ds pstep [0.005] 
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Bond paths are determined by numerical integration of the gradient vector Vp(r) along the line 
of maximum density, and pstep is the (initial) step-length for this integration. 

The following options apply to the calculation of the electrostatic potential (esp) only: 

radi rad1 [0.1] 


Calculations for points within a radius of rad1 of any atom will not be performed. Instead, 
arbitrary big values will be assigned. The properties at the nuclei however, will be calculated. 


rad2 rad2 [200.0] 


Atoms outside a radius of rad2 of a point will not be included in calculations. 


rad3 rad3 [10.0] 
Border between zone1 and zone2 (see below). 
zonel idf! [1] 


If idf1-1, contribution of an atom whose nucleus is between rad1 and rad2 but less than rad3 
away from the point of interest is evaluated without neglect of those due to dipolar and higher 
multipolar densities: 'exact' formulae used for all the multipoles. 


If idf1-0, the contributions of dipoles and higher multipoles are neglected. 'Exact' formulae 
used for monopoles only. 


zone2 id/2 [1] 


If idf2=1, contribution of an atom whose nucleus is between rad1 and rad2 but greater than 
or equal rad3 away from the point under question is evaluated in the following way: 'Exact' 
formulae for dipolar and higher multipolar densities, point charges for monopolar densities. 


If idf2=0, point charges for monopoles; higher poles neglected. 
6.2.6 DIPOLE 


DIPOLE *cmass (*)center (*)ucell 


The dipole moment can be calculated in one of three frames. cmass uses the center of mass 
as the origin, center the geometric center and ucell the origin of the unit cell. 


The user is referred to the excellent review by Spackman on computing molecular multipole 
moments from X-ray diffraction data [97]. The computation of the molecular dipole moment 
requires some definition of a ‘molecule’ in the crystal [98,99,100], since the positioning of the 
intermolecular boundary is arbitrary. XDPROP assumes that the density of a molecular 
fragment in the crystal is derivable from just the n pseudoatoms that would describe the free 
molecule. This ignores any overlap between pseudoatom multipole functions on neighbouring 
molecules. Then the dipole moment is given by 


p=} p, (Eq. 6-3) 
j=l 
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where 
p,-ZjR,- Í rp (r, dr (Eq. 6-4) 


R; is the nuclear position vector, and r=r-Rj. 
In a monopole-only refinement, the pseudoatom dipole contribution is given by 


p; -ZjR; - [e,(txe, +R )dr=q,R, (Eq. 6-5) 


which follows from the normalization of the monopole functions (fp ;(r)dr, =1), and the odd 


symmetry of the second integrand ( Í p,(r,)r,dr;, 20). Only the monopoles and dipoles 


contribute to pj due to the symmetries of the dm and the dipole operator. If the radial 
functions are normalized Slater-type functions 


n+3 
ER l n 76r - 
Rr) = (n42) £2) r'e (Eq. 6-6) 


then the remaining integrations may be performed analytically, to give 


p; -4;R; - Pra [dy Rjxdr (Eq. 6-7) 


-Ha fd, Ri ydr z P o | d,oR,zdr 
4P' (n, +3)! 
3k 56 , (n, + 2)! 


where P'; is the vector consisting of the dipole populations for the j^ atom. In general, each 
atom has its own local coordinate system so Pj must include the effect of a rotation A to a 
common cartesian frame: P'=APj. 


-qR, 


The dipole moment p is independent of the choice of origin (for a neutral moiety), but the 
dipole moment variance o(p) would normally be origin-dependent. However, the application of 
the neutrality constraint in XDLSM has an effect equivalent to minimizing the dipole variance 
with respect to the origin. Therefore molecular or fragment dipole moment variances computed 
with XDPROP should be origin-independent, provided that the neutrality constraint was applied 
appropriately during refinement. 


6.2.7 QUADPOLE 


QUADRUPOLE *cmass (*)center (*)ucell 
XDPROP can also compute quadrupole moments of a group of pseudoatoms, using the 
following definition of quadrupole operators: Qx-xy; Qxz-xz; Quz yz; Qz-(32-1?5; Q2-y2= V» (x?- 


y?) 


These operators are chosen because they are identical to the pseudoatom quadrupole density 
functions, apart from normalization factors. This means that only selected monopoles, dipoles 
and quadrupoles contribute to each quadrupole moment component, due to the orthogonality 
properties of spherical harmonics. 


The quadrupole moments are computed from the following formulae: 
Dio DV Zp PP) ig EY Dig Xp (Eq. 6-8) 
J 
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Dem 2 (Z; =P e Pa) tdg + Xj P je + 2; P jx (Eq. 6-9) 
j 


Q, = 3 yz; -P P) +I ye *Y;P Dy (Edenu) 
7 
l 
Qop = 2108 eoru. -Py)*td,a s +X) Pix — Vj P y (Eq. 6-11) 
j 


1 
Casa 2,;05 -xj- j£, -Pe Pp) t dus 2 +42 py -2x, p, -2y;p y (Eq. 6-12) 
J 


where Pj and Py are the core and monopole populations of the j-th pseudoatom. The dipole 
terms are given by 


4P,. (n, +3)! 


= Eq. 6-13 
Pi $e n2) Ca) 


(for pj, and py replace Pj;. with Pji- and Pio respectively). The pseudoatom quadrupole terms 
are: 


2n 


"pec y 0 + 3)(n, + 4) (Eq. 6-14) 
jj 


d js = 


(for qiz, Gjyz or qj. replace Pg». with Ppi+, Ppi- or Pp», respectively. The remaining 
quadrupole is 


__ 6v3 
50K 56 ;)’ 


xd_pro.out gives a complete ‘breakdown’ of pseudoatom contributions to each of the five 
molecular components in terms of monopole, dipole and quadrupole functions. The main 
number likely to be of interest is the total moment, appearing at the bottom right of the output 
for each component. 


disp = Py (n, + 3)(n; +4) (Eq. 6-15) 


6.2.8 EXPORT 
EXPORT *orient *min16 Imax [max nmol nmol natmol n1 n2... 


This command enables XDPROP to write out atomic moments in spherical tensor notation 
[101] in ORIENT [102] (when orient is flagged) and MIN16 [103] (when min16 is flagged) 
input formats. Imax defines the maximum level of atomic moments to be written. nmol defines 
the 'number of molecules’ present in the atom list (including atoms generated with APPLY and 
GROUP instructions). nl, n2 .. define the number of atoms in each of the molecules. By 
default there is only 1 molecule, which includes all atoms in the list. 


6.2.9 STOCKHOLDER partitioning and UNABRIDGED MOMENTS 


Integration of the electron density partitioned according to the Stockholder method [104] and 
corresponding unabridged moments can be performed. 
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The following lines are necessary in the mask of the xd.mas file: 


STOKMOM (*)defden Imin [min Imax Imax *cmass (*)center (*)ucell (*)debug 
STOKMOM minlim xmin ymin zmin maxlim xmax ymax zmax epsa epsa epsr epr 
STOKMOM ‘orient *min16 Imax [max nmol nmol natmol n1 n2 ... 

STOKMOM atoms (*)all (*)select ato(1) ato(2) ... 


(*)defden Imin [min [0] Imax [max [4] *cmass (*)center (*)ucell (*)debug 


defden defines the type of the density on which the integration is done. If flagged the 
integration of Stockholder moments is done on deformation density, otherwiseon the total 
density (the default). Imin and Imax define the limits of the moments to be integrated. cmass, 
center and ucell define the origin of the coordinate system (same as for DIPOLE and QPOLE): 
cmass uses the center of mass, center the geometric center and ucell the origin of the unit 
cell. debug, if flagged, enables more verbose output. 


minlim min [-3.] ymin [-3.] zmin [-3.] maxlim xmax [3.] ynaq3.] zmax [3.] epsa epsa [1.0d- 
4] epsr epr [1.0d-4] 


Parameters xmin ymin zmin xmax ymax zmax define the integration limits (in A) around each 
atom in the Cartesian frame. Parameters epsa and epsr define the accuracy of numerical 
integration, i.e. absolute (epsa) and relative (epsr) errors. 


*orient *min16 Imax Imax [4] nmol nmol [1] natmol n1 n2 ... 


Writes out Stockholder atomic moments in spherical tensor notation [101] in ORIENT [102] 
and MIN16 [103] input formats. Imax defines the maximum level of atomic moment expansion 
to be written. nmol defines the number of molecules' present in the atom list (including atoms 
generated with APPLY and GROUP instructions). n1, n2 .. define the number of atoms in each 
of the molecules. By default there is only 1 molecule, which includes all atoms in the list. 


atoms *all (*)select ato(1) ato(2) ... 


If select is flagged, only the specified atoms ato(1) ato(2) ... will be integrated, otherwise all 
atoms in the atom list will be integrated (default). 


6.2.10 D-POP 


Occupancies of the d orbitals can be derived (in the approximation of low overlap) according to 
the approach suggested by Holladay, Leung and Coppens,[105]. The option D-POP will give 
the calculated the d orbital occupancies in the output, for example: 


MULTIPOLE POPULATIONS 
POO 
2.376 


P20 P21+ P2d= P22+ P22- 
0.094 0.000 0.000 0.000 0.000 


P40 P41+ P41- P42+ P42- P43+ P43- P44+ P44- 
0.213 0.000 0.000 0.000 0.000 0.001 0.011 0.000 0.000 
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ORBITAL POPULATIONS 
z2 = 0.87065 

XZ = 0.32579 

yz = 0.32579 
x2-y2 = 0.42701 
xy = 0.42701 
z2/xz = 0.00000 
z2/yz = 0.00000 
z2/x2-y2 = 0.00000 
z2/xy = 0.00000 
xz/yz = 0.00000 
xz/x2-y2 = 0.00126 
XZz/XYy = 0.02387 
yz/x2-y2 = 0.02387 
yz/xy = -0.00126 
x2-y2/xy = 0.00000 


tot d-pop = 2.37625 


If (*)esd in the xdprop heading is flagged, estimated errors are also tabulated 


6.2.11 PROPERTY 
PROPERTY *prop 


XDPROP will analyse the property which is flagged with an asterisk (*) on the PROPERTY card 
(there should be only one such a card). The following are currently available: 


core Core density 

valence Valence density 

rho Total density (p) 

defden Deformation density (Ap) 

gradrho magnitude of gradient vector of p (Vp) 

d2rho Laplacian of p (V? ) 

elpot Electrostatic Potential V(r) using a crude approximation 
esp Electrostatic Potential V(r) using the method of Su and Coppens [112] 
nucpot Nuclear Potential (v(r)) 

sigrho Error in p 

siglap Error in V2p 

elf Electron localisation function 

oep One electron potential 


The core/valence decomposition of the electron density is based on the orbital occupations 
given in Xd.bnk * or in the SCAT table in the master file (see Section 4.6.2) 


Ap is the standard deformation density, i.e. the difference p -piaw. V(r) is defined as 


r-r' 


el Z; p(r) ! 1 
TO EU J dr (Eq. 6-16) 


where Rj and Z are the position and charge of the j-th nucleus, respectively. Outside the Van 
der Waals surface, it may be computed from an expansion in the multipole moments of 
individual pseudoatoms [106,107] 


POEN y 214 B = gx $0. Pu +...| (Eq. 6-17) 
7 r-R, "NES ri 2^ a 
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where q,p,Q... represent pseudoatom moments. A number of experimental charge density 
analyses using this type of multipolar representation of the potential have been reported 
[108,109,110,111]. In XDPROP, Vir) is computed using the method of Su and Coppens [112], 
which does not rely on a multipole expansion. Thus the potential may be computed at points 
inside the charge distribution, permitting the calculation of V, E, and the EFG at the nuclei, 
and exploration of the topology of V(r) [113]. 


The nuclear potential is just the contribution of the nuclei alone to (3.15), i.e. 


væ, !r- R,| (Eq. 6-18) 
J 


sigrho and siglap are computed with equation 6.2: currently only the contributions from 
population parameters and «’s are taken into account. Hence these should be considered lower- 
limits. Note that sigrho and siglap may be very tedious to compute, so you might want to 
think twice before trying to generate a cube of siglap data ! 


The electron localization function elf is computed based on the approximation for the kinetic 
energy density of A. Kirzhnits (Sov. Phys JETP, 1957, 5, 65) as recently applied by Tsirelson 
(Tsirelson, V.; Stash, A. Chem. Phys. Lett., 2002, 351, 142). NOTE: this approximation for the 
elf is very poor at the nuclear positions, so it is completely inappropriate to analyse the 
topology of this scalar field using XDPROP. 


The one-electron-potential function oep (Lassettre, E. N. J Chem Phys 1985, 83, 1709; 
Hunter, G. Int J Quantum Chem 1986, 29, 197; Kohout, M. Int J Quantum Chem 2001 83 324) 
is defined as: 
OEP = V^yp/QNp) = 1/4(V’p/p) — 1/8(Vp/py 

The following four options are for computing values of the active property (i.e. flagged on the 
PROPERTY card) at specified points, along lines, or over 2-D and 3-D grids of points. An 
unlimited number of POINT, LINE, MAP and CUBE entries may be present. However, 
depending on the computer operating system, the various map files which are produced may 


overwrite one another. Thus it may be necessary to re-run XDPROP every time you want to 
produce a new map file, or rename the files between runs. 


6.2.12 POINT (property at a point) 

POINT xyz 

This keyword followed by three coordinates in the global frame specifies a point at which the 
active property will be computed. No map file is created by this option, the result only 
appears in xd_pro.out. 

6.2.13 LINE (property along a line) 

LINE atom! atom2 npts npts 

This option computes the value of the active property along a line between two nuclei, 


specified by their atom labels. A final parameter which must be supplied is the number of 
(equidistant) points at which the property will be computed. So an example could be 


LINE C(1) 0(2) NPTS 21 


Alternatively, the user may ask a property along a line defined by points. 
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LINE POINTS x1 yl z1 x2 y2 z2 npts 50 


Note that x1,yl,zl and x2,y2,z2 are the Cartesian coordinates of the two points. 


6.2.14 MAP (property over a 2-D grid of points) 

MAP atoms atomi atom2 atom3 npts npts step step (*)trans tx ty tz 

MAP bvect1 x1 y1 z1 bvect2 x2 y2 z2 cen x0 yO zO npts npts step step 

There are two ways of specifying the plane with MAP. The first uses three atom labels, and the 
map centre is the centroid of the three atoms. The grid will be square (npts x npts), with a 
gridspacing of step in À. You can specify a translation of the origin, with respect to the grid 
axes. Translations of 1.0, 0.0, 0.0 or 0.0, 1.0, 0.0 will shift the origin 1 A along the x or y grid 
axis directions (+x leftwards in the horizontal, +y downwards in the vertical directions), 
respectively. The trans directive must be flagged to effect this. A translation of 0.0, 0.0, 1.0 
selects the plane parallel to and 1 À above the plane containing the three atoms (change the 
sign of the z translation to select planes below the plane of the atoms). The shifts in x, y and z 
can be non-integral. Thus an example is: 


MAP ATOMS C(1) C(2) O(1) NPTS 61 STEP 0.1 TRANS 0.5 0. 0. 


The second method is to supply two basis vectors, in the global Cartesian coordinate system. 
The map centre must be given in the global Cartesian frame. npts and step have the same 
meaning as before. A complete example is: 


MAP BVECT1 1. .0 .0 BVECT2 .0 .0 1. CEN 1.3 .2 -.1 NPTS 13 STEP 0.2 


A map file is produced with the filename structure xd mid prop.grd. The maximum value 
of npts is 150. 


6.2.15 CUBE (property over a 3-D grid of points) 

CUBE centre x0 y0 zO npts npts step npts 

CUBE atom1 atom2 npts npts step npts 

This generates an npts x npts x npts cube of the active property, with a grid spacing of step (in 
A). There are two ways of specifying the cube centre: in global cartesian coordinates, or as the 


midpoint of two atoms. Thus two examples are: 


CUBE CENTRE 0.3 9.82 1.5 NPTS 21 STEP 0.3 
CUBE C(1) O(3) NPTS 21 STEP 0.3 


A map file is produced with the filename structure xd mid prop.grd. The maximum value 
of npts is «75. 


6.2.16 CPSEARCH 


CPSEARCH bond atom! atom2 (frac frac) (scan delta) 
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CPSEARCH bond rmin rmin rmax rmax 

CPSEARCH ring atom! atom2 ... 

CPSEARCH point x y z 

CPSEARCH shell atom rmin rmin rmax rmax nrad nrad nang theta phi cutoff cutoff 
CPSEARCH start filename 

CPSEARCH BUBBLE atom rmin rmin rmax rmax curv icurv ncps npoints 


Topological analysis of the density is concerned with the scalar fields p and V?p but XDPROP 
allows the user to CP search any of the properties listed previously. In the case of the nuclear 
and electrostatic potentials, these have very similar topologies to p [35]. The usefulness of CP 
searching the defden is probably restricted to finding local (3,+3) minima or (3,-3) maxima, 
the latter (for example) would be bonded or non-bonded peaks in the defden. 


The search for CPs employs a 3-Dimensional Newton-Raphson technique, which requires both 
the gradient vector and the Hessian H (i.e. the 3 x 3 matrix of partial second derivatives of f 
with respect to {x,y,z}). Starting from some point, such as the midpoint between two nuclei, an 
improved estimate of a CP position rc is found from iterative application of 


po z r” -H7 Vf (Eq. 6-19) 


Each card beginning with CPSEARCH initiates a search of the property flagged with an 
asterisk on the PROPERTY card. Following CPSEARCH is a string which indicates how the 
searching is to be done. There are five modes of searching, which differ in how the starting 
coordinates are chosen, and how many times the CP search algorithm will be called. 

(i) bond can initiate a CP search between the two atoms whose labels follow, e.g. 


CPSEARCH BOND C(1) O(1) 


This type of search starts from the midpoint of the two nuclei. The frac option can be 
used to change this. 


CPSEARCH BOND C(1) O(1) FRAC 0.7 


This starts the CP search at a fractional distance of 0.7 times the C-O bondlength, i.e 
nearer to the oxygen. For bonds CPs which are tricky to find, a more thorough 
alternative is 


CPSEARCH BOND C(1) O(1) SCAN 0.3 


This carries out seven CP searches starting from (i) the midpoint of the nuclei {xo, Yo, Zo} 
as before, then at {xot5yYo,Zot, {Xo, Yot, Zot and {xXo,Yotd,Zotd}, where delta is the step (in A) 
which appears after scan. 


Alternatively if bond is followed by rmin instead of an atom label, then the program 
will search for all CPs between all pairs of nuclei with internuclear separations 
between rmin and rmax (in A). So typically, to locate all CPs between bonded first-row 


atoms one might use: 


CPSEARCH BOND RMIN 1.15 RMAX 1.6 
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(ii) ring carries out a CP search starting at the centroid of the atomic coordinates of the 


atom labels which follow, so typically for a phenyl one could use something like: 
CPSEARCH RING C(1) C(2) C(3) C(4) C(5) C(6) 


At least two atom labels should be supplied, and no more than eight. 


(iii) point starts a search from the Cartesian coordinates (in À) which follow. These must 


be coordinates in the global system, which is defined near to the top of the 
xd pro.out file. So the form of the command is: 


CPSEARCH POINT 1.2 -4.3 9.3 


(iv) shell is the most complex searching option, primarily intended for 


5 


vi 


— 


locating non-bonded charge concentrations in V’p, Ap, or Vir). An example 
would be: 


CPSEARCH SHELL O(1) MIN .5 MAX .7 NRAD 3 NANG 11 11 CUT 20. 


This searches in concentric spherical shells around O(1), with radii 0.5, 0.6 and 0.7 À 
(since the number of shells nrad=3), over an 11 x 11 angular grid of points in 0 and 6$ 
(polar coordinates, referred to the global cartesian system). The minimum number of 
points in both 0 and $ (nang) is two, and the minimum number of radial shells (nrad) is 
one. The algorithm operates in the following manner. Denoting the property being 
searched by flr), | Vf(r)| is computed at each point (7,0,0) in the shell (3 x 11 x 11 = 363 
points, in the above example). If a point is found where |Vf(r)| < 20.0, then the 
Newton-Raphson CP search algorithm is initiated at this point, to see if a nearby CP 
can be located precisely. This routine often finds the same CP many times. Useful 
values of cutoff vary so much with the property to be searched, the radial distance from 
the nucleus, and the atomic number of the atom, that it is difficult to give guidelines 
on sensible values (currently there are no default values in the program). Subsequent 
releases of the program may be more helpful in this respect, but for the moment it is a 
matter for trial and error, and perseverance! The example given above has successfully 
found both carbonyl oxygen lone pair (3,-3) critical points in V’p in low-temperature 
data sets for formamide and acetamide. 


start reads in a data file generated by a previous run of the properties program, and 
carries out a sequence of CP searches using the CP positions given in that file as 
starting coordinates. This may be useful (i) if the refinement model has been altered, 
but a set of CP positions have been computed for a previous model (ii) since it allows 
CP positions in one property to be used as starting points for searching another 
property. For example, the CPs in Vir), which are very rapidly computed, may provide 
useful starting points for searching p. An example of the command would be: 


CPSEARCH START XD FORMAMIDE.CPS 
where the last string is a filename. 


bubble allows a complete search of critical points around a given atom (useful 
especially when searching critical points of the Laplacian): 


CPSEARCH BUBBLE C(1) rmin 0.3 rmax 0.5 curv -3 ncps 2 
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curv is the signature of the critical point to be searched. ncps is the expected number 
of cps of this type around atom ato(1) - setting it to zero allows the search to continue 
until finished. Enlarge nstep (in the heading of xdprop) if a more thorough search is 
needed). A file xd bubble.spf is created with all CPs found for rendering in 
PLATON. 


6.2.17 QFIT 
QFIT npts npts length length width width constrain (true | false) 
CONSTRAIN keys ... 


This activates the potential-derived (PD) charges algorithm, which follows the procedure 
described by Williams & Cox [114,115]. A cubic grid of (npts)? points is centred at the centroid 
of coordinates of the active molecule. This grid is of size length À. V(r) is computed over this 
grid, and then a subset of these points in a shell of thickness width À is selected for the fit. 
This corresponds to a shell of points, whose inner surface is taken as the Van der Waals 
radius of the nearest atom, plus the Van der Waals radius of hydrogen. The residual 


2 
x^ = >a) V? ae (Es uk (Eq. 6-20) 
i J 


j 


(m is the number of grid points used in the fit; Vo is the exact potential from the multipole 
model at the i-th grid-point; qjis the PD charge for the j-th nucleus; rj is the distance from the 
j-th charge to the ith grid point; Z is the net charge on the molecule; and wiis the weight for 
the i-th point) is minimized by a least squares fit. In this version of QFIT, all grid-points have 
unit weights. The root-mean square fit parameter 


1/2 
TE B4 sjeg j (Eq. 6-21) 
m 


L 


is reported. Chemical symmetry constraints may be applied to the fitted charges. A full 
example is: 


OFIT NPTS 11 LENGTH 7.0 WIDTH 1.0 CONSTRAIN TRUE 
CONSTRAIN 12344 4 


If constrain is false then the CONSTRAIN line need not be present. The example above, which 
refers to a six-atom molecule, will fit independent charges for the first three atoms, and then a 
single (constrained) PD charges. This might be used e.g. in formamide where the last three 
atoms are hydrogens. A second example is for acetamide, where the amine hydrogens (atoms 
4 & 5) and methyl hydrogens (atoms 6-8) could be constrained to have equal PD charges 
within each group: 


CONSTRAIN 1.2 3 4:4 5 5-5 


It should be noted that there are many different ideas and algorithms for obtaining PD 
charges, and the routine in XDPROP is one of the more primitive. Algorithms which 
additionally constrain the point-charge dipole moment to reproduce some ‘exact’ moment have 
been available for some time [116]. A recent idea, based on reproducing V(r) at the nuclear 
sites, rather than in a volume around the molecule, has been developed by Su [117]. This 
gives charges which have some internal chemical significance for the molecule, rather than 
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optimally predicting its intermolecular interactions. This code may be incorporated in further 
releases of XDPROP. 


6.2.18 BPATH (Bond Path analysis) 
BPATH atom! atom2 algrithm (2| 6) (profile) 


The bond path (BP) is the line of maximum charge density joining two nuclei. It passes 
through the CP, and the technique for computing the BP trajectory is to carry out separate 
line integrations of Vp from the CP towards the two nuclei. The initial direction for this 
integration is determined by the CP eigenvector with the positive eigenvalue, approximately 
parallel to the internuclear vector. An analysis of the BP is mainly useful for detecting strain 
in bonds [118], since in such bonds the BP is significantly longer than the internuclear vector. 
Other parameters of interest are the take-off angles of the BP at the CP and the nuclei. These 
are angles between the BP and the internuclear vector. 


There are two BP-determining algorithms in XDPROP, with different levels of accuracy. The 
simplest uses an Euler second-order numerical integration technique, requiring only Vp ata 
point to extrapolate to the next step. The second is a sixth-order algorithm, which uses a 
number of prior points to extrapolate to the next step, and ought to be rather more accurate. 
BP files may be produced, which contain the coordinates of BPs at regular intervals along the 
path, so that they may be plotted using the graphics software supplied in XD. In the current 
version of XDPROP, these BP files are only produced if you use the cruder second-order 
algorithm. 


The command format is simple: 
BPATH C(1) O(1) ALGRITHM 2 


computes the BPATH between C(1) and O(1) using the 2-nd order algorithm, simultaneously 
producing a BP file for plotting. The more accurate sixth-order algorithm is selected by 
replacing the ‘2’ with a ‘6’ in the above example. 


If the option profile is added to the command line BPATH, which evaluates the bond path 
between two atoms, a complete Bond Path Analysis (p(r); V2p(r) and e) is performed and 
reported in the file xd profile.dat [119]. 


BPATH ato(1) ato(2) algrithm 2 profile 


Here is an example of xd profile.dat 


# 
# bond path 1 between atoms FE and C(1) 
# 
# r (A) ellip rho (e/A^3) Laplacian (e/A^5) 
0.0000 0.1249 1.0201 7.0729 
-0.0060 0.1275 1.0205 7.5554 
-0.0110 0.1296 1.0212 7.9684 


The origin is fixed at the bcp, two 'legs' are printed (one for each atom). If more than one 
BPATH command is requested, then the following bond path analyses are simply appended. 
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If the option check is flagged, the xdprop output file xd pro.out contains full analysis of 
each point along the bond path integration (density, Laplacian, Hessian, diagonalisation of the 
Hessian matrix, direction of the eigenvectors, etc.). 
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Chapter 7 


XDFOUR - A General 2-D And 3-D Fourier 
Synthesis Program 


7.1 Overview 


The aspherical atom model used in multipole refinement gives structure factor phases closer 
to the true phases for non-centrosymmetric crystals than does the spherical or independent 
atom model (SPH). This permits mapping of the density by Fourier synthesis in various ways. 
The experimental deformation map is obtained using the calculated multipole phases with the 
observed structure factors Fo: 

ibe pee 


Fspi(h) is computed with atomic positions and thermal parameters obtained from the multipole 
refinement. The dynamic model map is obtained from the calculated multipole structure 
factors, i.e. the Fourier coefficients are the difference of two values of Fe: 


1 i —2rih-r 
dp T (r) m 3 lr (h) F P o (h) e is k dus 
Vt 


(temperature factors are included in Fmu and Fspn). This density distribution is free of 
experimental noise. The use of multipole phases makes the maps slightly model-dependent; 
to check that all significant density features of the experimental data are included in the 
model we compute the residual map: 


p) - z Y [r;ay|- Ir, ane em 
V 
h 


For good data this should be a flat, featureless map. 


aes Es (h) 


8° (r) = => TAY 


e ID mut 


Crystallographic Fourier synthesis programs (except the FFT type) compute the density 
distribution as 


p(r) = <> [A(h) cos 2th -r + B(h) sin 2h - r] 
h 
where A(h)-*iB(h)-F(h). For the total density map the Fourier coefficients are 
A(h) = |F, (h) coso 
Bch) =|F, (h)sinó 
For the experimental deformation map 
A(h) = |F, (h)|}coso 
Bch) =|F, (hb) sing 
For the dynamic model map 
A(h) = Fu (h) COS O ny EI [Fs (b) coso y 
B(h) F Tu (h) sin ny) i Fon (b) sin Pyy 


mul 


mul 


- |F,,, (h)|cosó,,, 
F,,, (h) sin, 


mul 


mul 
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For the residual map 
T d (h|lcoso,,,, 


F,,,(h)|sino,,, 


AQ) = [F, dy - 
B(h) = |F, (h)|- 


XDFOUR computes a 2-D or 3-D Fourier summation on a grid oriented either with respect to 
a general (non-rational) plane, without interpolation errors, or with axes parallel to the 
crystallographic axes. 


7.2 Files used and created by XDFOUR 


Input: xd.mas, xd.res, xd.fou 
Output: xd_fou.grd, xd_fou.out 


7.3 Input instructions for XDFOUR 


7.3.1 SELECT 


SELECT (*)fobs (*)fmod1 (*)fmod2 (*)print snlmin snimin snlmax snimax 
fobs, fmod1, fmod2 


The coefficients for the summation are defined here. The reflection file contains the observed, 
dispersion-removed structure factors F.°, and two sets of calculated structure factors. Fc may 
be computed by the least squares program according to various alternative density models, 
e.g. independent atom, multipole, static, anharmonic, and any two of these may be selected 
for output of the corresponding Fc (see FOUR instruction for XDLSM.) The starred options in 
the SELECT line signify the type of coefficient to be used. If two are starred then the 
coefficients are formed from the difference of the corresponding Fc sets. If only one is starred, 
it forms the coefficients. In the example below, the SELECT line specifies a residual map with 
coefficients Fo-Fimuitipoie. In this case the Fe set labelled fmod1 has been defined in the least 
squares program as Fmulttipole. 


SELECT *fobs *fmodl fmod2 

Note that Fc must be calculated without anomalous dispersion (so that the scattering factors 
are real) as signified by zero as the third parameter after fmod1 in the XDLSM section. Fourier 
maps are computed without dispersion, hence it is removed from Fo also. 

As a further example, one would obtain a dynamic model map by including 

FOUR fmodi1 4 2 0 0 fmod2 -1 2 0 0 

in the XDLSM section, and 

SELECT fobs *fmodl *fmod2 

in the XDFOUR section. The Fourier coefficients are then formed as the difference between 
the dispersion-removed multipole Fe and the dispersion-removed independent atom Fe. Note 


that in this example no extinction correction is applied. This is signified by the final zero in 
the fmod1 and fmod2 options of XDLSM. 
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print 


The results listing file will include the grid of density values if this option is starred. A grid file 
(xd. fou.grd) suitable for input to the graphical programs is always written. 


snlmin snimin snlmax snimax 


This option defines the stol range for which Fourier coefficients are included in the 
summation. 


7.3.2 APPLY 

APPLY symm is trans tx ty tz (atoms ... | all) 

This command is used to apply a symmetry operation to the pseudoatoms in the asymmetric 
unit. This is used only to include the additional atoms on the gridfile for plotting purposes. 
The symmetry operations are referenced according to the sequence in which they are listed at 
the start of the output from the program. For example, 

APPLY SYMM 3 TRANSLATIONS -2 -1 1 O(1) N(1) C(1) H(1) H(2) H(3) 

applies the third symmetry operation, with the lattice translations shown, to the six atoms 
whose labels are given. If a symmetry operation is to be applied to all atoms in the 
asymmetric unit, then the keyword all may replace the pseudoatom labels. More than one line 
beginning with APPLY may be present. 

7.3.3 GRID 

GRID (*)3-points (*)perp (*)cryst 


The GRID line should specify one of the following options: 3-points, perp, or cryst preceeded 
by an asterisk, e.g. 


GRID  *3-POINTS  PERP CRYST 


This means that the option 3-points is selected. 
3-points and perp 


In case the option 3-points or perp is chosen, at least 3 points must be specified. There are 3 
types of formats. 


1. ATOM label atom (symm symop) (trans tx ty tz) (*)mark 
atom must be identical to an atom label given on the parameter file. 


2. ATOM no no (symm symop) (trans tx ty tz) (*)mark 
no is the sequence number of an atom in the parameter file. 


3. XYZ (label label) x y z (symm symop) (trans tx ty tz) (*)mark 
label is a label which may marked on the plot. The fractional coordinates x y z are free 


format real numbers. 


Common for the three formats are the options: 
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e symm symop where symop is the sequence number of an operation in the list of space 
group operations which appears at the start of the program output. 

e trans tx ty tz indicating three lattice translations (positive or negative integers). 

e (*)mark If flagged with a star, the position is marked on the plot. 


The first 3 points are used to define a right-handed orthonormal coordinate system in the 
following way. The origin of this coordinate system is the centroid of the three points in the 
list. For the option 3-points, the points define the xy plane; the x-axis is parallel to the vector 
from point 1 to point 2 and the third point is in the half-plane y>O. For the option 
perpendicular, the xy plane is perpendicular to the vector from point 1 to point 2; the 
projection of the third point onto the xy plane defines the direction of the x-axis, x>0. 


cryst 


In this case the grid has oblique axes parallel to the crystallographic axes a, b and c. Of the 
commands described below, only LIMIts, TRANslate and PERMute should be used in this 
case. 


7.3.4 TRAN 


Having defined a first orthonormal coordinate system, we may define the final grid-coordinate 
system by any of the following operations on it, in any order, and as many of them as you like. 
The operations are: 


e Translation of the coordinate system origin, command TRAN 

e Rotation around axes through the origin, command ROTA 

e Permutation of the axes, command PERM 
As soon as a line is read, the operation is performed on the coordinate sytem, and the next 
operation acts on this new coordinate system with respect to its axes. The command for 
translation is 


TRAN tx ty tz 


The interpretation of tx ty tz depends on the option chosen on the GRID-line : 
e *3-points: tx ty tz are in Angstroms 
e *perp: tx ty are in Angstroms, tz in fractions of the vector from point 1 to point 2. 
e *cryst: tx ty tz are in fractional coordinates 


7.3.5 ROTATE 
ROTA eulerian alpha beta gamma 
ROTA axis angle 


a, B, y are the Eulerian rotation angles: first a rotation of a degrees about the x-axis, then p 
degrees about the new y-axis, and finally y degrees about the new z-axis. 

axis: X, y or Z 

angle equals the angle (degrees) which the coordinate system is rotated about the coordinate 
axis given by axis. An example: the result of these four instructions is to leave the coordinate 
system unchanged. 


ROTATE EULERIAN 45 -54.5 90 


ROTATE Z -90 
ROTA Y 54.5 
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ROTATE Z -45. 
7.3.6 PERM 
PERM new-x new-y new-z 


new-x, new-y, new-z: some permutation of x, y or z. An example: How to generate a left- 
handed system by turning z into -z ? Here is one way of doing it: 


ROTAtion Y 90 
PERMute ZYX 


7.3.7 LIMITS 


This command defines the limits of summation. A 3-dimensional grid is obtained when all 
three axes have more than one grid point. 


LIMI (keyword value) ... 
Where keyword is any of the following (default values in brackets): 


xmin [0] xmax [1. nx [41] 
ymin [O0.] ymax [1. ny [41] 
zmin [0.] zmax [0.975] nz [40] 


Pmin and Pmax are the limits of the box dimensions along the respective coordinate axis. n? is 
the number of grid points in this direction. It is stressed that the limit information is only 
applied to the final grid-coordinate system. Example: a 2-D grid is defined. The sense of the 
y-axis is inverted since ymin>ymax. 


LIMITS XMIN -2. XMAX 2. NX 41 
LIMITS YMIN 2. YMAX -1. NY 31 
LIMITS ZMIN 0. ZMAX 0. NZ 1 


Default values assumed by the program divide the cell up into 40 sections, each having 41 x 
41 points. 
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Chapter 8 


XDFFT - A Fast Fourier Transform program 


8.1 Overview 


XDFFT is a 3-D fast Fourier Transform program operating over the whole unit cell, and using 
the algorithm and code of Ten Eyck [120]. It includes a peak searching routine, and is adapted 
from the GX programs FFT and SEARCH [121]. Since the calculation time scales as NlogN 
rather than N?, it is at least an order of magnitude faster than a corresponding calculation 
using XDFOUR. It will probably be most useful for determining the extrema of the residuals 
after refinement. 


8.2 Files used and created by XDFFT 


Input: xd.mas, xd.res (or xd.inp), xd.fou 
Output : xd_fft.out, xd_fft.cif and optionally xd_fft.grd, 
xd_fft.pks 


8.3 Input instructions for XDFFT 


8.3.1 SELECT 


SELECT *fobs *fmod1 fmod2 (*)snlmin snimin (*)snlmax snimax (*)sig sigcut (*)phase 
phasecut 


fobs, fmod1, fmod2 


The selection of these coefficients for the Fourier calculation is exactly as described for 
XDFOUR (see Chapter 7). The default calculation is a difference Fourier. If a difference Fourier 
is selected, then the program writes out a CIF called xd_fft.cif, containing the maximum and 
minimum and RMS densities. 


snimin snimin snlmax snlmax 

These options define the sin(theta)/lambda range for which Fourier coefficients are included in 
the calculation. The default values are snlmin 0.0, snimax 2.0. The ranges will only be applied 
if the corresponding items are starred. 

sig sigcut phase phasecut 

These options define cut-offs for which Fourier coefficients are included in the calculation. 
Only those reflections with I/o(J) > sigcut, and with |F.| > phasecut | F;| will be included. The 


default values are sigcut 3.0, phasecut 0.0. The cut-offs will only be applied if the 
corresponding items are starred, and the default is to apply no cut-offs. 
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SELECT gridsize grdsize scale scale npeak peaks nhole holes (*)neutron (*)gridf (*)peakf 
gridsize grdsize 

The grid spacing in Angstroms. The default value is 0.2 A. The maximum number of grid 
points in any direction is 200. If the chosen grid spacing results in more than 200 points 
along any axis, the spacing is automatically increased by the program. 

scale scale 

The electron density scale factor. Currently not in use 

npeak peaks / nhole holes 

The number of peaks and holes required in the peak searching routine. Default values are 10 
for both. Input atomic positions are read from the xd.res (or xd. inp) files, and all details 
and interpretation of the map is listed in the file xd fft.out. 


neutron 


If this item is starred, then holes will also be included in the peaks interpretation. The default 
is not to include holes in the interpretation. 


gridf 

If this item is starred, then an XD gridfile xd fft.grd is written. Users should note that the 
planes are always calculated along the y direction, with the z direction varying fastest, which 
is different from XDFOUR. Since this file can be very large and is probably of little use, the 
default action is not to write a gridfile. 

peakf 

If this item is starred, the peaks selected by the search routine are written to the file 
xd_fft.pks. 
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XDGRAPH - Visualising the Results 


9.1 Overview 


The graphics program differs from the rest of the package in one major way. To account for its 
interactive nature, it is not driven by the master file, but instead is controlled by a command 
language. The Tool Command Language (Tcl, by J.K.Ousterhout) was chosen because it 
provides a general scripting language in which special application-defined commands are 
easily integrated. The Tcl based toolkit (Tk) for the X11 Window System was then used to add 
a graphical user interface on top of the existing commands. 


9.2 The Command Line Interface 


XDGRAPH roughly follows the concept of Tk with its commands. For each type of high-level 
'object' one can work with (examples of objects are datasets, contour levels, etc.), a command 
exists to create this object (e.g. dataset, contour). This, in turn, creates a new command with 
the same name as the object. Actions on the object (apart from creation) are performed using 
that ‘object command’. The different actions available for an object are called subcommands. 


The name of an object must follow certain rules: 


e All names start with a ':' (colon). 
e Objects that are derived from other objects (ie. from datasets) start with the name of 
that object, separated by a colon. 


For example a valid name for a dataset would be :set1, and a possible name for a contour level 
group derived from that dataset would be :setl:plus. In addition to the 'object oriented' 
commands, more 'action oriented' commands are available. They are mostly implemented as 


Tcl-procedures. 


XDGRAPH distinguishes between the creation of an object and the actual graphics output. 
The latter is considered an action you perform on this object by using the object's 
subcommand 'plot'. 


So the general scheme to create a plot looks like this: 


Load the data you want to visualize from a file 
dataset :set001 -load xd defden.grd 


Create some graphical objects 
contour :set001:plus -val (0.1 0.2 0.3 0.4 0.5] 
contour :set001:zero -val 0. -style dash 
molecule :set001:mol 


Display those objects 
:set001:plus plot 
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:set001:zero plot 
:set001:mol plot 


9.3 The Graphical User Interface 


The graphical user interface to XDGRAPH reflects the command structure described in the 
previous section. A dialog box exists for each object which allows to enter the options the 
respective command takes. Online help, access to reasonable default values, menu lists, file 
and colour browsers support the user entering required data. 


Daata TT [- IF} x] 
use default a pariti: Cptians 
value 
X Mane yelow bg 
ed «| ++- required field 
use original A wew 
helper menus 
—— Ea _ | | for some fields 
«KI de 
Face EE linear 
gom 
Vertical Pccekeratiun am 


View/nide .: Style Options 
roups of 
aa ll = Mew Options 


ük Hnt Cinal 
* + 


apply the options apply the options 
and plot the object 


Figure 9-1: A sample dialog box from the graphical user interface 


Here is the example from the previous section, this time using the GUI: 
(Menu entries are written as 'Menu::Submenu' ) 


Load the data you want to visualize from a file 
Choose File::Load Dataset and fill in the necessary fields. You can get support to 
enter the file name from a directory browser. Which file selector is actually used 
depends on the Tcl/Tk release. Starting with 8.0, the internal file selector which comes 
with Tk is used. For older versions XD's own selector is used. You can force its use by 
setting the environment variable XD USE PRIVATE FSBOX. A list of allowed file types 
is available as a menu. Use 'Ok' to finish this step. 


Create and plot a simple graphical object 
Choose Create::Contour. Again, a dialog box appears. See Figure 10-1 for details. 
Use 'Plot' to finish this step. 


Create and plot the second group of contour lines 
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Same procedure as above. Open the 'Style Options' part of the dialog box and use the 
'Linestyle' menu to specify dashed lines. 


Finally, add a representation of the molecule to the graphics 
Use Create::Molecule. Again, use 'Plot' to finish this step. 


9.4 Running XDGRAPH 


SYNOPSIS 
xdgraph (options) (tcl-script) 


OPTIONS 
-d driver 
select a driver (tk or gt) 


9.5 Commands 


Some of the options and subcommands are marked with a star (*). They are common to more 
than one command. Their descriptions can be found in sections 10.4 & 10.5. 


9.5.1 dataset 
Create a dataset or list existing datasets. 
SYNOPSIS 


Dataset ?dataSetPattern? 
Dataset name -load fileName options 
Dataset name -slice sourceDataSet options 


DESCRIPTION 


This command has different uses, depending on the number of arguments. The first form of 
the command, with at most one argument, returns a list of existing datasets. If no pattern is 
specified all datasets are listed, otherwise only those matching the given pattern are returned. 
A list of special character sequences for pattern matching can be found in section 10.9.3 

The second form of the dataset command, which requires at least two arguments, creates a 
dataset. This can either be done by reading a file (requires -load as the first option) or by 
interpolating another dataset (if -slice is given as the first option). In either case, the first 
argument is the name of the new dataset. 

The following set of options is available for the file reading version of the dataset command: 


OPTIONS 
-load fileName 
The name of the file to be read. The GUI provides a file selector box for Unix users. 
Note for VMS users: Please read the section about file name syntax in Tcl in 
section 0. Remember that square brackets | ] and dollar signs have special meanings in 
Tcl. 


-type fileType 
The format (and to some extent the content type) of the file to be read. Valid file types 
are: 
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aim 
A grid file, format as used by some version of the AIM package. 

xddata 
This is used for xy-diagrams. It contains a list of arbitrary data points, with 
possibly multiple values per point. Still experimental! 

xdgrid 
Grid files contain data on a rectangular grid, together with a list of objects 
(atoms and critical points). Either 2- or 3-dimensional grids are possible. 
XDPROP and XDFOUR write grid files using this format. 

xdpath 


This type of file is written by XDPROP if a bond path calculation with algorithm 


2 was done. 


The following set of options is only available for the slicing version of the dataset command. 
This option is not yet available in the GUI. 


OPTIONS 


-slice sourceDataSet 
-Spoint* p1 p2 p3 
-nx numXPoints 
-ny numXPoints 
-nz numXPoints 
-xmin minXCoord 
-xmax maxXCoord 
-ymin minYCoord 
-ymax maxYCoord 
-zmin minZCoord 
-zmax maxZCoord 


SUBCOMMANDS 


configure* options 
connections -auto 
Generate a list of connections between atoms based on their distance. 


CONTOUR 


Returns a list of all contour level groups created from this dataset. 
heightfield 
Returns a list of all height field objects created from this dataset. 
info* 
Output some information about the dataset. 
interpolate 
Only available for slices. Re-calculate the data values by interpolating in the original 
dataset given when the slice was created. This subcommand must be used after 
rotate and translate subcommands. 
isosurface 
Returns a list of iso-surface objects created from this dataset. 
molecule 
Returns a list of molecule objects created from this dataset. 
path 
Returns a list of bond path objects created from this dataset. 
property 
Returns the property this dataset maps. 


83 


Chapter 9 - XDGRAPH - Visualising the Results 


relief 
Returns a list of relief objects created from this dataset. 

remove* 
Remove this dataset. 

rotate options 
Only available for slices. Rotate the slice. Note, that this command does not re- 
calculate the data values. You have to call the interpolate subcommand explicitly. 
Different options are available: 
-eulerian angle1 angle2 angle3 
-x angle 
-y angle 
-z angle 

translate /x y zj 
Returns a list of xy-diagram objects created from this dataset. 

colorbg min max 
Draw a filled rectangle on each grid point. The colour is chosen by mapping the given 
range 
(defaults to the whole range of values in the grid) to 256 colours in a colour map 
(Currently the colour map can't be changed by the user. A fixed map 
$xd datadir/default.cmap is used.Values outside the given range are not filled. 


EXAMPLES 

> dataset :ox -load xd_drho.grd 
> dataset 

< :0X 


9.5.2 contour 


Create a group of contour levels from data on a rectangular grid. 


SYNOPSIS 
contour name Poptions?P 


DESCRIPTION 

This is used to visualize data on a 2-dimensional grid by drawing smooth lines connecting 
points of equal value. XDGRAPH handles groups of lines for different data values together as 
single objects. To get a complete contour map you usually create a few groups with different 
style options to distinguish different data ranges (for example positive and negative values.) 


OPTIONS 


Specific Options 
-plane* plane 
This is used to select a plane from a 3-dimensional grid. 
-values valueList 
A list of values, for which contours are to be drawn. When used with a configure 
subcommand, the list overwrites the previous one, while when used with append the 
new values are appended to the existing list (appended, not merged!). 
Note, that this is a 'list' in the Tcl sense: 
contour :d1:clg -values O. 1. 2. is not correct 
contour :d1:clg -values (0. 1. 2.) this is the correct usage using curly braces f) 
-vertac vertAcc 
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This scales the data values to z coordinates. It is useful to prevent clipping and when 
adding contour lines to a height field. Currently only used when the OpenGL driver is 
in effect. 

-view view 
The view this contour group should use. See Section 9.5.9 for details about the default 
behaviour, which should be reasonable for most simple applications. 


Style Options 

-foreground | -fg* colour | (colour1 colour2) 
This option takes either a single colour (see Section 10.6 on different ways to specify a 
colour) or a list consisting of two colour values. When two colours are given, the first 
one is assigned to the first contour level and the second one to the last contour level in 
the group. Intermediate values are interpolated. Note that the way the colours are 
specified influences intermediate colours. (See section on common options). 

-style* lineStyle 
The line style (solid, dotted, etc.) used for this contour group. 


View Options 
See section O for a list of possible options. 


SUBCOMMANDS 
configure* options 
Change options for an existing contour line group. See previous section for a list of 
possible options. 
append options 
This is like configure, except that any -values given with append are added to the 
contour group, while those given with configure overwrite the previous list. 
clear* 
Remove the contour group from its view. 
info* 
Output some information about the contour group. 
plot* 
Display this contour group, adding it to its view. 
remove 
Delete the contour group. 


9.5.3 height field 


Create a smooth surface from data on a rectangular grid where the height corresponds to the 
data values. Only available with OpenGL. 


SYNOPSIS 
height fieldheightField Poptions? 


DESCRIPTION 
This is used to visualize data on a 2-dimensional grid by drawing an open surface on the grid 
which is elevated according to the data values. 


OPTIONS 


Specific Options 

-cutoff cutOff | (lowCut highCut 
Limits the maximum and minimum elevation. If only one value is given, it specifies the 
upper cutoff limit. The lower cutoff value is - cutoff in this case. 

-map name 
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For future use. 

-plane n 
This is used to select a plane from a 3-dimensional grid. 

-vertac vertAcc 
This scales the data values to z coordinates. Reasonable values depend on the mapped 
property. 

-view view 
The view this contour group should use. See section 8.3.9 for details about the default 
behaviour, which should be reasonable for most simple applications. 


Style Options 

-foreground | -fg* colour | {colour1 colour2} 
The colour of the surface, changed by lighting calculations. Currently only one colour 
is used. 

-polygon* polygonMode 


View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 
configure* options 
Change options for an existing height field object. See previous section for a list of 
possible options. 
clear* 
Remove the height field from its view. 
info* 
Output some information about the height field. 
plot* 
Display this height field, adding it to its view. 
remove* 
Delete the height field. 


9.5.4 iso-surface 


Create a group of contour levels from data on a rectangular grid. Only available with 
OpenGL. 


SYNOPSIS 


isosurface name Poptions? 


DESCRIPTION 


This is used to visualize data on a 3-dimensional grid by drawing smooth surfaces 
connecting points of equal value. Surfaces are represented by triangles which can be 
rendered using solid planes, lines or points. The later two options make it possible to see 
surfaces inside of one another. 


OPTIONS 
Specific Options 


-values valueList 
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A list of values for which iso-surfaces are to be drawn. When used with a configure 
subcommand, the list overwrites the previous one, while when used with append the 
new values are appended to the existing list (appended, not merged!). 

-view view 
The view these iso-surfaces should use. See section Ofor details about the default 
behaviour, which should be reasonable for most simple applications. 


Style Options 
-foreground | -fg* colour 
The colour used two draw this iso-surfacc. -style* lineStyle 
The line style (solid, dotted, etc.) used in case the polygonMode is set too line. 
-polygon* polygonMode 
How to render this iso-surface. 
fill 
Solid 
line 
Lines 
point 
Points 


View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 
configure* options 
Change options for an existing iso-surface. See previous section for a list of possible 
options. 
append options 
This is like configure, except that any -values given with append arc added to the iso- 
surfaces, while those given with configure overwrite the previous list. 
clear* 
Remove the iso-surface from its view. 
info* 
Output some information about the iso-surface. 
plot* 
Display this iso-surface, adding it to its view. 
remove* 
Delete the iso-surface. 


9.5.5 molecule 


Visualize the molecule from a grid file or a bond path calculation. 


SYNOPSIS 
molecule name PoptionsP 


DESCRIPTION 

The molecule as read from a grid or bond path file is visualized according to the view type 
used. For a contour or bond path view a line drawing is used, while for an iso-surface view a 
ball-and-stick model is used. 


OPTIONS 
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Specific Options 
-atoms drawAtoms 

Include or exclude atoms from the display. drawAtoms is a boolean (on, off, yes, no). 
-bonds drawBonds 

Include or exclude bonds from the display. drawBonds is a boolean 
-label drawLabels 

Include or exclude labels from the display. drawLabels is a boolean 
-view view 

The view this molecule should use. 
-zlimit zlimit 

Exclude atoms further away from the plane than zlimit Angstrom. 


Style Options 
Not yet. 


View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 


configure* options 

Change options for an existing molecule. See previous section for a list of possible 
options. 
clear* 

Remove the molecule from its view. 
info* 

Output some information about the molecule. 
plot* 

Display this molecule, adding it to its view. 
remove* 

Delete the molecule. 


9.5.6 path 
Create a path plot from path data. 


SYNOPSIS 
path name Poptions? 


DESCRIPTION 
This is used to visualize data from a bond path calculation. 


OPTIONS 


Specific Options 
-view view 
The view this bond path plot should use. 


Style Options 
-foreground | -fg* colour 
The colour used for this bond path plot. 
-style* lineStyle 
The line style (solid, dotted, etc.) used for this bond path plot. 
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View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 
configure* options 
Change options for an existing bond path plot. See previous section for a list of 
possible options. 
clear* 
Remove the bond path plot from its view. 
info* 
Output some information about the bond path plot. 
plot* 
Display this bond path plot, adding it to its view. 
remove* 
Delete the bond path plot. 


9.5.7 relief 
Create a relief plot from data on a rectangular grid. 


SYNOPSIS 
relief name Poptions? 


DESCRIPTION 

Create a relief plot, ie. the data is visualized as view of a landscape, using the value on each 
grid point as its height. The transformation into the display plane is chosen by giving a 
viewpoint. 

Currently, a number of restrictions apply: You can't select a plane from a 3-dimensional grid 
and you can't choose in which direction lines are drawn (currently always along x and y). 


OPTIONS 


Specific Options 

-cutoff cutoffValwe | fhighCutoff lowCutoff} 
When used with one value, this option limits the absolute value of any data point to 
cutoffValue. When a list with two values is given, the high and low cutoff values can be 
given separately. 

-eye (xy zj 
The eye-point is a point in 3d-space from where the relief is viewed. The viewer is 
always looking across the map to the corner O., O., O. This is a parallel projection, so 
only the ratio of the three 
numbers is used. The default value is (1. 1. O.6). 

-size {hSteps vSteps) 
The number of lines to draw parallel to x and y, respectively. Defaults to the number of 
grid points. 

-vertac scaleFactor 
Gives a scale factor from data values to y-plot coordinates. This defaults to fitting the 
data to the plot size. Note, that you probably want to use this option, in case you used 
any of the cutoff options. 

-view view 
The view this contour group should use. See section Ofor details about the default 
behaviour, 
which should be reasonable for most simple applications. 


Style Options 
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-foreground | -fg* colour 
The colour used for this relief plot. 
-style* HneStyle 
The line style (solid, dotted, etc.) used for this relief plot. 


View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 
configure* options 

Change options for an existing relief plot. See previous section for a list of possible 
options. 
clear* 

Remove the relief plot from its view. 
info* 

Output some information about the relief plot. 
plot* 

Display this relief plot, adding it to its view. 
remove* 

Delete the relief plot. 


9.5.8 xydiagram 
Create an xy-diagram, experimental. 


SYNOPSIS 
xydiagram name Poptions? 


DESCRIPTION 
OPTIONS 


Specific Options 
-type point | line 
-view 

-x i | varName 
-y i | varName 


View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 
configure* options 
clear* 

info* 

plot* 

remove* 


9.5.9 view 
Create a view (window). 


SYNOPSIS 
view name -type type Poptions? 
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DESCRIPTION 

A view is used to create a connection between graphical objects (like contour lines or 
molecules) and the screen. It is an abstract object which manifests itself as an X11 window. 
name: The name of the view object to create. Please note, that view names don't follow the 
rules for other objects in XDGRAPH. They don't have to start with a colon and they are not 
derived from any object. 

type: The type of the view corresponds to the kind of objects shown. There is no separate view 
for molecules. Molecules may use any of the other view types (except xydiag and relief). The 
way molecules are represented depends on the type of view. E.g. in a contour view it is a 
simple line drawing whereas in a surface view a 3D ball and stick model is used. 

Whenever you create a graphical object using a non-existing view (explicitly or implicitly) a 
view of the appropriate type is created automatically. Its name is derived from the dataset the 
object belongs to and the type of the object. For molecules a contour view is used. If you want 
to draw a molecule in another type of view, you must specify the name explicitly using the - 
view option. You can either create the view by hand or create the other object first and use 
the automatic name. 


The following view types are available: 
contour 

height 

path 

relief 

surface 

xydiag 


OPTIONS 


View Options 
See section Ofor a list of possible options. 


SUBCOMMANDS 
configure* options 
Change options for an existing view. See previous section for a list of possible options. 
matrix 
Print, the 4 by 4 transformation matrix. This can be used to restore an orientation 
obtained using the mouse. This is currently implemented as ddr 
objects 
Returns a list of objects connected to this view. 
rotate options 
Rotate the view. Not yet implemented!!! 
-x angle 
-y angle 
-z angle 
translate (x y z} 
Translate the view. Not yet implemented!!! 


9.6 Common Options 

View Options 

These options are available for all graphics objects as well as for views. When used with 
graphics objects, they are applied to the related view, however. You cannot transform one 


object separate from another in the same view using these options. 


Size and Scaling 


91 


Chapter 9 - XDGRAPH - Visualising the Results 


-width width 
-height height 
-scale scaleFactor | auto 


The first two options set the size of the view (in cm). If negative or not specified, this is 
calculated from vranye and scaleFactor. If no scale factor is given either, a default of 18cm is 
used. 
The scale factor is used to transform Angstrom to cm, a value of one meaning that on 1cm in 
the plot corresponds to 1A in the data. 
If the scale factor is less than or equal to zero or specified as auto, the data is scaled to fit into 
the view. This requires -vrange to be specified. 
If all three options are given, the view might not be fully used or clipping might occur. 
-vrange {xrange yrange} 

For a grid file, this gives the length of the x and y axis of the grid (in A). 


Translation and Rotation 

-matrix matrix 
Transformation matrix, matrix is either a 3 by 3 or a 4 by 4 transformation matrix. This 
is mainly useful to restore a matrix from a previous run. (See section 8.3.9). This 
option is not yet fully implemented !!! 

-origin {x y z} 
Shift the objects before rotation. 

-translate {x y z} 
Shift the plot after rotation but before scaling. (So this is in Angstrom.) 


-3point pi p2 p3 
An easy way to give origin and orientation. p,is the origin, p, — p, gives the positive x 
axis X. The 
z axis Z is given by Xx(p, — p,), and Zx% is the y axis. Each of the points may be 
specified in one of the following ways: 
(px Py Py} 
A list, giving the coordinates directly. 
label 
The object label. 


Style Options 


-foreground or -fg colour 
Sets the foreground colour(s) used to draw an object. The colour can be given in a 
number of ways. 
name 
XD's own database is used to convert colour names to RGB values when 
necessary, (i.e. not for Tk) 
RGBtriple 
X Window System style #rgb, #rrggbb #rrrgggbbb #rrrrggggbbbb with f’, ‘g’, ‘b’ 
being hex digits 
{RGB red green blue} 
red, green, blue: [0., 1.] 
{HSV hue saturation value} 
hue: [0.,360.) 0. is red, saturation: [0., 1.], value: [0.,1.] 
{YUV luminance u v} 
luminance, u, v: [0.,1.], u, v: [-0.5,0.5] 
-polygon polygonMode 
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How to draw polygons. One of the following: 


solid 

Draw solid, shaded faces. 
line 

Draw the shaded edges of the polygons. 
point 


Draw only the vertices of the polygons. 
-style lineStyle 
Sets the line style. lineStyle is either the keyword solid or a string build from the 
following elements. 


' ' (blank) 
Empty space. You can use multiple blanks to add more space. For example the string ' 
dot dot dot' would draw a line with three dots close to each other, separated by a 
larger space. If there are no trailing blanks given a single one is added automatically. 


dot 

A dot. 
dash 

A dash. 
long 

A long dash. 


Valid examples are: 'solid' (default), 'dot' or 'dot dash'. 


Other Common Options 

-plane n 
This is used to select a plane from a 3-dimensional grid. For those grids, an xy-plane is 
plotted and the parameter n selects the n'th section along the z-axis. The first plane is 
numbered 1, which is also the default value for this option. Rarely used. 

-view view 
The view the object will use. See section Ofor details about the default behaviour, 
which should be reasonable for most simple applications. This option is only 
meaningful while objects are created. Currently, the behaviour when used with the 
configure subcommand is undefined. 


9.7 Common Subcommands 
configure options 


Change options for an existing object. The options that can be used are the same as for 
the command that is used to create the respective object type. 


info 
Show some information about the object. 
plot 
Plot the object. 
clear 
The object is removed from the display 
remove 
Delete the object. The object command is removed and the associated memory is 
released. 
view 


Return the view this object is using. 


9.8 Toolbox 
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9.8.1 sleep 


SYNOPSIS 
sleep seconds 


DESCRIPTION 
Sleep (do nothing) for seconds seconds. 


9.8.2 plot 


SYNOPSIS 
plot ?datasets? 


DESCRIPTION 
Plot all objects derived from the given dataset(s). Default are all datasets. 


9.8.3 clear 


SYNOPSIS 
clear ?datasets? 


DESCRIPTION 
Clear all plotted objects derived from the given dataset(s). Default are all datasets. 


9.8.4 hardcopy 


SYNOPSIS 
hardcopy ?-file filename? ?-width width? ?-height height? 


DESCRIPTION 

Dump the contents of the currently active display to file. The actual semantics of this 
command depend on the display driver in use. 

When used with the Tk driver, the output will be a PostScript file. Width and height are 
standard Tk measures, they default to the size of the window. The default filename is 
xdgraph.ps. 


Unfortunately, the OpenGL driver is only capable to output pixel oriented data. Currently, the 
file is written as a PBM file (Portable BitMap file). Conversion utilities to other pixel file formats 
are available from many ftp servers around the world. The default file name is xdgraph.ppm. 
Width and height are given in pixels. The default of 500 is only suitable for test purposes. The 
optimal value depends on your printer and the type of graphics shown. Start with values 
around 1500 for serious work. Use the Tk driver for line drawings such as contour maps. The 
PostScript output is much better suited for this purpose. 


Linux users may find that the hardcopy option for the OpenGL driver is not functioning (a 
message about no "visual for dump" is given). In this instance, hardcopy may be obtained with 
the Linux utility program import, by screen-grabbing the window. The image may be saved in 
several formats include PostScript and GIF, and may also be resized. See 'man import' for 
further details of command syntax for import. The command line is given in any terminal 
window and the actual image is grabbed by then clicking on the window displaying the desired 
graphic with the mouse. For example, to save as a PostScript file 
import image.ps «CR» then click desired window with mouse 
or to save as a GIF with 150% expansion in image size 


94 


Chapter 9 - XDGRAPH - Visualising the Results 


import image.gif -geometry 150% <CR> then click desired window with mouse 
9.8.5 generate 


SYNOPSIS 
generate type Pnsteps Pstart Pincrement??? 


DESCRIPTION 
Return a list of values. Very useful where values for contour levels have to be given, type 
maybe one of 


lin 

Create a linear range of nsteps values, starting with start, adding increment. 
geo 

Create a geometric range of nsteps values, starting with start, multiplying by increment. 
aim 


{ .001 .002 .004 .008 .02 .04 .08 .2 .4 .8 2. 4. 8. 20. 40. 80. 200. 400. 800.} 
maim 
As aim, but with negative sign. 


EXAMPLES 

contour :dl:plus -values [generate lin 10 0.1 0.1] 

Is the same as 

contour :dl:plus -values {0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0} 


9.9 Display Driver 


Currently, XDGRAPH interfaces to two different libraries for the actual display/plotting. One 
is the X11 Window System toolkit 'Tk' already mentioned. It is the preferred display driver on 
any platform with X11 available (note that this includes VMS systems with DECwindows). It 
requires the installation of Tk. 


In the future, there will be some instructions to add your own display driver into xdgraph. At 
the moment the internal interface is still not stable. 


The Tk driver has some special features: 


e The atomic labels in contour and path plots can be moved using the mouse. Move the 
cursor over the text and wait until the colour changes. Than press the left mouse button 
and drag the label over the display. Release the mouse button when you're satisfied with 
the placement. This does not move the marker of the atom, just the label. 


9.10 Examples 
The following examples can be found in source directory $TOP/xdgraph/exa. 


9.10.1 bw.tcl 

This creates a contour plot from the data in file xà defden.grd. The dataset is called :1. 
For positive and negative contour levels the generate command is used. The -style option is 
used to draw the zero level and negative levels with a different line style. The command plot is 
used to plot the three contour level groups together with a title, atom labels and some further 
info. 


dset :1 -load xd defden.grd 

contour :1:plus -val [generate lin 10 0.1 0.1] 

contour :l:zero -val 0. -style dash 

contour :l:minus -val [generate lin 10 -0.1 -0.1] -style dot 
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plot 


9.10.2 colramp.tcl 


This creates a contour plot with coloured contour lines. Because two different colours are 
given for positive and negative contour level groups each contour level has a different colour. 
The YUV colour model is used to specify the colours because it is especially useful for 
interpolation. Unfortunately, it is not easy for humans to relate a specific colour to an YUV 


triple. 

dset :1 -load xd defden.grd 

contour :1:plus -val [generate lin 15 0.1 0.1] N 
-foreground {{YUV 0.6 0.6 0.1) (YUV 0.1 0.7 0.44}} 

contour :1:zero -val 0. -style dash 

contour :1:minus -val [generate lin 10-0.1-0.1] \ 


-fore {{YUV 0.9 0.2 0.5} {YUV 0.2 0.4 0.88}} 


plot 


9.11 A few words about Tcl 


9.11.1 Syntax 

The following list is derived from the Tcl man page. It gives almost all rules that define the 
syntax of the Tcl language. The examples mainly make use of two of the features: Quoting 
strings with curly braces ({ }) and command substitution with square brackets ([ ], which 
executes the enclosed string and substitutes it with the result). 


A Tcl script is a string containing one or more commands. Semi-colons and newlines 
are command separators unless quoted as described below. Close brackets are 
command terminators during command substitution (see below) unless quoted. 


A command is evaluated in two steps. First, the Tcl interpreter breaks the command 
into words and performs substitutions as described below. These substitutions are 
performed in the same way for all commands. The first word is used to locate a 
command procedure to carry out the command, then all of the words of the command 
are passed to the command procedure. The command procedure is free to interpret 
each of its words in any way it likes, such as an integer, variable name, list, or Tcl 
script. Different commands interpret their words differently. 


Words of a command are separated by white space (except for newlines, which are 
command separators). 


If the first character of a word is double-quote ( then the word is terminated by 
the next double-quote character. If semi-colons, close brackets, or white space 
characters (including newlines) appear between the quotes then they are treated as 
ordinary characters and included in the word. Command substitution, variable 
substitution, and backslash substitution are performed on the characters between the 
quotes as described below. The double-quotes are not retained as part of the word. 


€ 6» “) 


If the first character of a word is an open brace ('{) then the word is terminated by the 
matching close brace (71). Braces nest within the word: for each additional open 
brace there must be an additional close brace (however, if an open brace or close brace 
within the word is quoted with a backslash then it is not counted in locating the 
matching close brace). No substitutions are performed on the characters between the 
braces except for backslash-newline substitutions described below, nor do semi- 
colons, newlines, close brackets, or white space receive any special interpretation. 
The word will consist of exactly the characters between the outer braces, not including 
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the braces themselves. 


e If a word contains an open bracket (|) then Tcl performs command substitution. To do 
this it invokes the Tcl interpreter recursively to process the characters following the 
open bracket as a Tcl script. The script may contain any number of commands and 
must be terminated by a close bracket (|). The result of the script (i.e. the result of its 
last command) is substituted into the word in place of the brackets and all of the 
characters between them. There may be any number of command substitutions in a 
single word. Command substitution is not performed on words enclosed in braces. 


e Ifa word contains a dollar-sign ('$') then Tcl performs variable substitution: the dollar- 
sign and the following characters are replaced in the word by the value of a variable. 


e If a backslash (V) appears within a word then backslash substitution occurs. In all 
cases but those described below the backslash is dropped and the following character 
is treated as an ordinary character and included in the word. This allows characters 
such as double quotes, close brackets, and dollar signs to be included in words 
without triggering special processing. The following table lists the backslash sequences 
that are handled specially, along with the value that replaces each sequence. 

\a Audible alert (bell) (0x7). 

\b Backspace (0x8). 

\f Form feed (Oxc). 

\n Newline (Oxa). 

\r Carriage-return (Oxd). 

\t Tab (0x9). 

\v Vertical tab (Oxb). 

\<newline>whiteSpace A single space character replaces the backslash, newline, and 
all white space after the newline. This backslash sequence is unique in that it is 
replaced in a separate pre-pass before the command is actually parsed. This 
means that it will be replaced even when it occurs between braces, and the 
resulting space will be treated as a word separator if it isn't in braces or quotes. 

\\ Backslash (V). 

\ooo The digits ooo (one, two, or three of them)]give the octal value of the character. 

\xhh The hexadecimal digits hh give the hexadecimal value of the character. Any 
number of digits may be present. 


Backslash substitution is not performed on words enclosed in braces, except for 
backslash-newline as described above. 


e Ifa hash character ('#') appears at a point where Tcl is expecting the first character of 
the first word of a command, then the hash character and the characters that follow it, 
up through the next newline, are treated as a comment and ignored. The comment 
character only has significance when it appears at the beginning of a command. 


e Each character is processed exactly once by the Tcl interpreter as part of creating the 
words of a command. For example, if variable substitution occurs then no further 
substitutions are performed on the value of the variable; the value is inserted into the 
word verbatim. If command substitution occurs then the nested command is processed 
entirely by the recursive call to the Tcl interpreter; 110 substitutions arc performed 
before making the recursive call and no additional substitutions are performed on the 
result of the nested script. 


e Substitutions do not affect the word boundaries of a command. For example, during 


variable substitution the entire value of the variable becomes part, of a single word, 
even if the variable's value contains spaces. 
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9.11.2 Some built-in commands 

A very handy Tcl command is source. This is used to begin reading further commands from a 
file, switching back to stdin at the end of the file. For example, you could copy the file bw.tcl 
(see above) into you current directory and use it by typing source bw.tcl inside XDGRAPH. 


9.11.3 Pattern Matching 

* Matches any sequence of characters including a null string. 

p Matches any single character. 

[chars] Matches any character in the set given by chars. If a sequence of the form x-y 
appears in chars, then any character between x and y, inclusive, will match. 

\x Matches the single character x. This provides a way of avoiding the special 
interpretation of the characters *? [| V in the pattern. 


9.11.4 Notes for VMS users 

Because of the special use of square brackets [] in Tcl you can't give filenames with directory 
specifiers without precautions. For example, if you want to read in a file 
[datadir.pro]xd_fou.grd, you have to specify the filename in one of three ways: 


Quote the whole filename: 
dset :d1 -load f[datadir.pro]xd. fou.grdj 


Quote the brackets only: 
dset :d1 -load \[datadir.pro\|xd_fou.grd 


Give the filename in Unix-style. You must give a device name in this case: 
dset :d1 -load /device/datadir/pro/xd fou.grd 


Similar considerations apply to filenames with dollar signs. Use one of the first two methods to 
overcome this problem. In some cases it might be better to define a DCL logical name. This is 
especially true for the initialization files Tcl, Tk and XDGRAPH automatically include at 
startup. 

Let's assume the startup file for XDGRAPH can be found in the directory SYS$SYSDEVICE: 
[XD. LIB. TCL]. Using the following logical names will hide the dollar sign from Tcl. 


$ define TCL.DISK SYS$SYSDEVICE 
$ define XD TCLDIR /tcl disk/xd/lib/tcl 


Note however, that this particular example should only concern the person responsible for 
installation. 


9.11.5 Notes for Windows users 


The Windows release of XD contains an executable version of XDGRAPH which is linked with 
version 8.3 of the Tcl/tk library. The necessary runtime libraries TCL83.DLL and TK83.DLL 
are supplied, as well as all the Tcl/tk system files. Unfortunately, the OpenGL driver is not 
available for this version of XDGRAPH, so several functions like iso-surface plots are not 
working. See Section 13.4 on installation. 
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Chapter 10 


TOPXD - Full Topological Analysis 
10.1 Overview!22 


In order to fully incorporate the Quantum Theory of Atoms in Molecules [123] (QTAM) into 
routine X-ray charge density studies, the existing program TOPOND98 [124], originally written 
for the CRYSTAL98 package [125] has been adapted for the experimental charge-density 
package XD [126]. While the evaluation of several charge density properties at the critical 
points is already included in the XDPROP program, the TOPXD program provides several 
addional features. The main ones are its capability to define atomic basin boundaries and to 
integrate density functions within the basins, thus producing an extensive set of atomic 
properties, including net charges, dipole and higher electrostatic moments. 


TOPXD allows the user to undertake : 


e fully-automated chain-like searching for critical points in the p and V?p scalar fields, using 
either conventional Newton-Raphson techniques or the eigenvector following method 
[127,128] 

grid searching of critical points in the asymmetric unit 

evaluation of atomic properties 

finely tuned algorithms for the evaluation of atomic interaction lines or of atomic graphs 
extensive 2D and 3D graphical representations. 


The experimental electron density and its analytical derivatives up to order 2 are calculated 
using the same subroutines as XDLSM. However, derivatives of a higher order (up to 4) are 
required when searching for Laplacian critical points in the field of the Laplacian of the 
electron density. Derivatives of the third and fourth order are evaluated in TOPXD as a 
numerical finite-difference approximation of the first and the second order analytical 
derivatives. The numerical derivative approach has been described before [129] and was 
shown to be extremely useful when no analytical derivatives are available. For that purpose 
well known central-difference expressions with fourth-order error ( O(h*) ) have been used 


[130]: 
f 2 =f inh + 8f. = PE "Fs 
? 12h i 


"nol my +16f an -30 f, +16f Jyh 
f= 12h? 


where x is the point at which the numerical derivative is evaluated and h is the step size. 
Higher order numerical derivatives (or partial derivatives) are not needed, because every 
derivative of order 3 to 4 can be represented as first or second order finite-difference numerical 
approximation of the first or second order analytical derivative using a simple chain rule, for 


example: 
dòp _d|d’p|_d|/d’p|_d’|dp 
dx’dy dx|dxdy| dy| d? | dx’| dy |’ 
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in which expressions in square brackets are analytical derivatives while the outer part is 
evaluated numerically. 


The accuracy of the numerical differentiation of the electron density has been extensively 
tested by comparison of the numerical first and pure second derivatives with those obtained 
analytically for a number of (3,-1) critical points and for some arbitrarily selected points. With 
a step size of h=5x10-3, the expected error in the numerical derivatives is only O(h*)- 6.25x10- 
10, Numerical examples show the actual error to be less than 1x102 and practically 
nonexistent when double precision variables are used (as is the current default for TOPXD). A 
comparison of analytical mixed second derivatives with those obtained by numerical finite- 
difference differentiation of the first analytical derivative shows the difference to be less than 
1x102. A drawback of numerical differentiation is that in order to approximate one derivative, 
several evaluations of the function are required. Indeed, in order to obtain a numerical 
approximation of a pure secon derivative, for example d?p/dx?, evaluation of density is 
required at 5 different points. Fortunately, due to the exceptional computational power of 
modern computers such evaluations are only slightly more costly than using pure analytical 
expressions. 


TOPXD works in the XDPROP-like ‘global’ Cartesian system. All input and output atomic 
Cartesian atomic coordinates are assumed to be in Angstroms. Also, in some cases, fractional 
atomic coordinates can be used. The charge density and its derivatives can be in either 
atomic units (au) or electrons & Angstroms. Internally, TOPXD uses ONLY atomic units. 


10.1.1 Input Files and Running TOPXD 


TOPXD requires only two input files: 
xd.mas — XD master file 
xd.res(xd.inp) - XD parameter file 


The standard XD parameter file with atomic positional and multipole parameters is used by 
TOPXD. 


The XD master file (xd.mas) should contain the TOPXD specific instructions described in the 
next section of this manual. The current version of XDINI provides a default mask for TOPXD. 


Once the desired TOPXD instructions are included and activated in XD master file, TOPXD 
can be run via command line: 


topxd >& «topxd-output-file» & (Unix/Linux) or 
topxd «topxd-output-file» (Windows console version) 


where topxd is the name of the TOPXD executable file and «topxd-output-file» is a legal 


filename such as "topxd.out". Both XD master and parameter files must be present in the 
current directory, otherwise the program stops and the error message is printed. 
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10.1.2 Description of Acronyms 


Acronym 
QTAM 


p(x) 
V?p(r) 


H(p(r)) 
Ak 
CP(s) 
(m,n) CP 


BCP 
ZFS 


Atomic Basin 


NNA 


NEA 
AIL 


‘Crystal Graph' 


AGL 


VSCC 


IR 
EF 


Description 
Quantum Theory of Atoms in Molecules (R.F.W. Bader) 
Electron density 
Laplacian (VeV) of p(r) 
The Hessian (second derivatives) matrix of p(r) 
Eigenvalues (Ai<A2<A3) of H(p(r) ) 
Critical point(s): a point r where a given scalar f has Vf(r)=0 
A critical point with rank m and signature n. The rank is the 
number of non-zero eigenvalues, the signature is the difference 
between the number of positive and negative eigenvalues of H(p(r)) 
at the CP. 
Bond Critical Point [ a (3,- 1) CP in the p(r) scalar field | 
Zero-Flux-Surface [Vp(r).n(r) 20 Vre surface] 


The space traversed by all the uphill Vp(r) paths which terminate 
at a nucleus, which acts as a 3D attractor for its basin. The atomic 
basin is also the portion of space enclosed by a ZFS and including 
a nucleus. 

Non-nuclear attractor: a (3,-3) CP of r at a position other than 
nuclei 

Non-Equivalent (unique) Atom 

Atomic interaction line ( a curved path joining two nuclei along 
which p is a maximum with respect to any lateral displacement ) 
The network of AILs for a given crystal geometry (it is the crystal 
correspondent of the QTAM molecular graph for an isolated 
molecule) 

Atomic graph line (a curved path joining two -V?p(r) (3,-3) CPs 
along which -V2p(r) is a maximum with respect to any lateral 
displacement) 

Valence shell charge concentration (the atomic valence shell region 
where V?p(r) is negative ) 

Integration Ray (in atomic properties evaluation) 

Eigenvector Following method (CP search) 


10.2 TOPXD Instructions 


TOPXD reads both general XD instructions (CELL, LATT, SYMM and SCAT) and TOPXD- 
specific instructions from the XD master file (xd.mas). The TOPXD specific instructions begin 
with *MODULE TOPXD and be terminated by the END TOPXD line, in the same manner as 
other XD modules. Input is in free format and NOT case sensitive, as it is internally converted 
to upper case. Blank lines and lines beginning with the exclamation mark (!) are treated as 
comments and are ignored. Most of the XD conventions regarding the format and style of the 


xd.mas file are also be valid for TOPXD instructions. 


All TOPXD instructions begin on a new line, usually with a keyword (usually a four-character 
keyword) at the start. Curly brackets '}' denote an optional input. If in doubt as to the required 


syntax, see the example xd.mas file shown in Chapter 12. 


There are several sections in TOPXD program, each identified by a special keyword: 
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section purpose 
TRHO topological analysis of p(r) 
TLAP topological analysis of V2p(r) 
ATBP atomic basin properties 
PL2D 2D plots 
P2DCRY Visualization of 2D plots 
PL3D 3D plots 
VZ3D 3D visualization of atomic basins 


10.2.1 General Instructions 


General instructions are the first to be specified in *MODULE TOPXD part of the xd.mas file 
and apply to all TOPXD sections that follow. All these instructions are optional, i.e. the 
defaults are provided internally for all of these options, yet it is recommended to always 
include these instructions in the xd.mas file. 


The following general instructions can be specified: 


10.2.1.1 COMT 
COMT comment-string 


comment-string is a comment for TOPXD run. It is read in free format as CHARACTER*80 
variable starting from fifth character in the COMT.... line. The default is no comment. 


10.2.1.2 DEBG 
DEBG (*)symeqv (*)derive *check 


(*)symeqv 

When flagged this option creates the file gen eq.log with extensive information about 
symmetry-equivalent atoms generated using SYMM (see Section 2.2.1.5) and CGEN (see 
below) instructions. This file can be large, so generally this option would only be used for a 
first time one run of TOPXD for a particular compound, in order to check if symmetry- 
equivalent atoms have been generated properly. The default is not to create the gen eq. log 
file 


(*)derive 

When activated it enables the debugging printout of charge density and its derivatives to file 
debug rho.1log for each xyz point. When using this option, please make sure that plenty 
of the disk space is available. In general, one should not use this option at all. The default is 
not to print this file. 


(*)check 
This prints extra debugging information when enabled 


10.2.1.3 CGEN 
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CGEN alim xmin xmax blim ymin ymax clim zmin zmax 


xmin xmax 

Minimum and maximum allowed fractional coordinates of atoms along the unit cell axis a for 
generating of symmetry equivalent molecules (atoms). The default is -1.0 2.0, ie. only atoms 
with -1. « x « 2. will be generated 


ymin ymax zmin zmax 
These are similarly defined along the unit cell axes b and c respectively and have the same 
defaults. 


10.2.1.4 MPAR 
MPAR rcut rcut dstep dstep (*)au (*)iam 


rcut 
Maximum distance from xyz point to contributing pseudoatom in Angstroms (as in XDPROP). 
The default is 4.0 À. 


dstep 

Numerical differentiation step in Angstroms (as in XDPROP). This parameter will only be 
applied to numerical evaluation of the third and fourth derivatives of p(r) (see Section 10.1) 
since first and second derivatives are always evaluated analytically. The default is 0.005 (A) 


(*)au 

If activated all output parameters related to charge density and its derivatives will be in atomic 
units, otherwise the units are electrons and Angstroms. This keyword has no effect on ATBP 
section of TOPXD, in which the output is ALWAYS in Atomic Units. 

The default (except for the ATBP section) is electrons and Angstroms 


(*)iam 

If activated the independent atom model (IAM) will be used in calculation of charge density 
and its derivatives, i.e. all multipole populations ( l2 1) are set to zero; monopole populations 
are set to free atom values and « parameters are set to unity. Otherwise the multipole model 
specified in XD parameter file is used. 


10.2.1.5 DGRD 
DGRD (*)use (*)gen (*)fra gstep dx dy dz (*)read (*)ascii filename 
(*)use 


If activated TOPXD will use the 'density on the grid' method. The default is not to use the 
‘density on the grid’ method. 


(*)gen 
If activated TOPXD will generate the grid based on multipole parameters given in XD 
parameter file. 


(*)fra 
If activated the grid spacing parameters dx dy and dz specified after gstep are in fractional 


units. Otherwise dx dy and dz are in Angstrom units. 


(*)read 
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If activated TOPXD will read the external grid file and ignore whatever multipole parameters 
are specified in XD parameter file. 


(*)ascii 
If activated, the gridfile specified by the filename is in ASCII (text) format, otherwise it is a 
binary file. 


10.3 Topological Analysis of Electron Density 


In TOPXD, the search for (3,-3) CP's associated with the nuclear maxima is skipped, since the 
Slater type basis functions used in the multipolar expansion correctly yield a cusp at the 
nuclear position (and hence no CP). The non-nuclear attractor (3,-3) CP's can be recovered 
either as termini of a bond path associated to a (3,-1) CP or in the grid search for CP's (see 
Section 10.3.6). 


10.3.1 Auto critical point search within molecular clusters built around 'seed' 
point(s) 


This is a fully-automated and chain-like search strategy for all kinds of critical points using at 
each stage the eigenvector-following (EF) step suitable for the kind of CP searched for. The 
search is performed within a finite region of space, which encloses a finite molecular cluster 
built-up around a specified 'seed point' A. The size and origin of the cluster are given in 
following input. 


TRHO (*)seed (*)all (*)ail (*)debug nstep nstep nnb nnb rmax rmax th th 
| (*)fra | ()car] x y z (several of these lines may be present) 


(*)seed 
If activated, the search is performed. Otherwise no search is undertaken. 


(*)all 

If this keyword is activated, all kinds of CP's are searched for, otherwise the chain-like search 
is stopped after the (3,-1) CP stage. This option saves the largest part of the CPU time (if 
keyword ail is not activated) required by the automatic search. It is useful when very large 
clusters are defined around the seed point. 


(*)ail 

If this keyword is activated (*ail) atomic interaction line (AIL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. Otherwise atomic interaction line lengths and termini 
are not evaluated. This option is very compute-intensive ! 


(*)debug 
Activation of this keyword enables the debug printing during the CP search 


nstep nstep 
nstep determines the maximum number of EF steps along each search 


nnb nnb 

The value of nnb determines the maximum number of symmetry-related stars of atoms to be 
included in the cluster generated around the 'seed point'. nnb also defines the number of 
neighbours in the nearest neighbour analysis around each unique CP (of any kind) found 


rmax rmax 
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rmax is maximum radius of the clusters (A). Each cluster includes all atoms within a sphere of 
radius rmax, centered on the 'seed-point' A. rmax may locally reduce the actual value of nnb 


th th 
If th is not zero, the (3,-1) CP search is performed among all the unique atom pairs whose 
internuclear distance falls below th (A). Otherwise (th=0.0) the default value is used (5A) 


[(*)fra | (*)car] x y z 

This command must begin on a new line !. Coordinates (x y z) of the 'seed point' A (center of the 
cluster) in fractional (fra) or Cartesian (À) (car) units. Repeat this line N times for N 'seed 
points' (one 'seed point' per line). A search for a particular 'seed point' will only be performed if 
either of the keywords fra | car is activated (ie. *car or *fra) 


10.3.2 Auto critical point search within molecular clusters built around each of 
the unique atoms 


This is a fully automated and chain-like search strategy for all kinds of critical points, using at 
each stage the eigenvector following (EF) step suitable for the kind of CP searched for. The 
search is performed within a finite region of space, which is defined by building-up finite 
molecular clusters centered on each of the unique atoms of the unit cell. The size of clusters is 
given in input. 


TRHO (*)cluster (*)all (*)ail (*)debug nstep nstep nnb nnb rmax rmax th th 


(*)cluster 
If activated, the search is performed. Otherwise no search is undertaken. 


(*)all 

If this keyword is activated, all kinds of CPs are searched for. Otherwise the chain-like search 
stopped after the (3,-1) CP stage. This option saves the largest part of CPU time (if keyword ail 
is not activated) required by the automatic search. It is useful when very large clusters are 
defined around each unique atom. 


(*)ail 

If this keyword is activated (*ail) atomic interaction line (AIL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. Otherwise atomic interaction line lengths and termini 
are not evaluated. This option is very compute-intensive 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 
nstep determines the maximum number of EF steps along each search 


nnb nnb 

The Value of nnb determines the maximum number of symmetry-related stars of atoms to be 
included in the cluster generated around each unique atom. nnb also defines the number of 
neighbours in the nearest neighbour analysis around each unique CP (of any kind) found 


rmax rmax 
rmax is maximum radius of the clusters (A). Each cluster includes all atoms within a sphere of 


radius rmax, centred on the unique atom. rmax may locally reduce the actual value of nnb 


th th 
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If th is not zero, the (3,-1) CP search is performed among all the unique atom pairs whose 
internuclear distance falls below th (A). Otherwise (th=0.0) the default value is used (5A) 


10.3.3 Auto critical point search between unique atom pairs 


TRHO (*)pairs meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax th th (pc pc 


(*)pairs 
If activated, the search is performed. Otherwise no search is undertaken. 
meth is the method for a CP search and can be specified in one of the following formats: 


nr The Newton-Raphson (NR) algorithm is used in the CP search 


ef type The eigenvector-following (EF) algorithm is used in the CP search. The value 
of variable type depends on the kind of CP to be searched for (only one type 
can be specified per instruction). It is a three-character string, either 
ncp/bcp/rcp/ccp for (3,-3), (3,-1), (3,* 1) or (3,*3) critical points respectively. 
Use the ncp type only when a non-nuclear attractor is searched for since 
the (3,-3) critical points is not found in TOPXD for nuclear positions. 


an Cioslowski's analytical determination of atomic interaction lines [131] 

(*)ail 

If this keyword is activated (*ail) atomic interaction line (AIL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. Otherwise atomic interaction line lengths and termini 
are not evaluated. This option is very compute-intensive ! This keyword can not be 
activated if meth-an 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 
nstep determines the maximum number of EF or NR steps along each search 


nnb nnb 

(3,-1) CPs are searched among all the unique pairs generated from a set of nuclei. The set is 
generated by constructing clusters of atoms around each unique atom of the unit cell. The 
value of nnb determines the number of stars of neighbours used in the cluster construction 
around each unique atom. 


rmax rmax 
rmax is maximum radius of the clusters (À) (see nnb nnb above). rmax value may (locally) 
reduce the actual value of nnb 


th th 
If th is not zero, the (3,-1) CP search is performed among all the unique atom pairs whose 
internuclear distance falls below th (A). Otherwise (th=0.0) the default value is used (4A) 


{ pe pe } 

should only be specified if meth=nr 

pc£0 : if a CP is not found between A-B atom pair, the starting point of the NR search is 
displaced along the internuclear axis from the mid-point of the axis to the following two 
positions : r’stat= rAtpc*(rB — ra ); T"start = Fat(1. — po)*(ra — ra ), 

pc=0 : specifies the default value of pc (0.4). 
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10.3.4 Critical point search from a starting set of points 


TRHO (*)points meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax [fra | car | 
X y z (several of these lines may be given) 


(*)points 

If activated, the search is performed. Otherwise no search is undertaken. 

meth is the method for a CP search and can be either nr or ef type as specified in Section 
10.3.3 


(*)ail 

If this keyword is activated (*ail) atomic interaction line (AIL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. Otherwise atomic interaction line lengths and termini 
are not evaluated. This option is very compute-intensive ! 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 
nstep determines the maximum number of EF or NR steps along each search 


nnb nnb 
The value of nnb defines the number of star of neighbours in the nearest neighbour analysis 
around each unique CP (of any kind) found. 


rmax rmax 

rmax is the maximum distance (À) from the CP, considered in the nearest neighbour analysis 
around each unique CP found (see nnb nnb above). rmax value may locally reduce the actual 
value of nnb 


[car | fra | 
The coordinates of starting points are assumed to be in fractional (fra) or Cartesian (A) (car) 
coordinates 


x Y z 

This command must begin on a new line ! Coordinates of the starting point (units depend on 
car | fra keyword above ). Repeat this line n times for n starting points (one set of coordinates 
per line) 


10.3.5 Critical point search along the line joining two nuclei or two general 
points 


TRHO (*)line meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax 
<line specification> 


(*)line 

If activated, the search is performed. Otherwise no search is undertaken. 

meth is the method for a CP search and can be either nr or ef type as specified in Section 
10.3.3. In this case, the Newton-Raphson method is strongly recommended unless looking for 
a specific type of CP along the line to the exclusion of all others. 
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(*)ail 

If this keyword is activated (*ail) atomic interaction line (AIL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. Otherwise atomic interaction line lengths and termini 
are not evaluated. This option is very compute-intensive ! 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 

determines the maximum number of EF or NR steps along each search. Use a very small 
number of steps in this case, say no more than 5-8, since the search is repeated 40 times, 
starting from 40 evenly distributed points along the line. 


nnb nnb 

The value of nnb defines the number of star of neighbours in the nearest neighbour analysis 
around each unique CP (of any kind) found. 

rmax rmax 

rmax is the maximum distance (A) from the CP, considered in the nearest neighbour analysis 
around each unique CP found (see nnb nnb above). rmax value may locally reduce the actual 
value of nnb 


This next command begins on a new line ! 
<line specification> can be given in one of the following two formats: 


(*)Jatom label toneighbor il... i(n) 

CP search along the line(s) joining the unique atom A with label label and its il..i(n) 
neighbour(s) (atom B), where i is the 'NEW' number in the 'Clusters around each of the 
unique atoms' printing at the beginning of the TOPXD output. The search will only be 
performed if keyword atom is activated (i.e., *atom). Repeat this line n times for n unique 
atoms. 


(*)point | car|fra] x1 yl z1 x2 y2 z2 

CP search along the line joining two points a and b with coordinates (x1 y1 z1) and (x2 y2 z2), 
respectively. The coordinates are in Cartesian (Å) (car) or fractional (fra) units. The search 
will only be performed if keyword point is activated (i.e., *point). Repeat this line n times for n 
point pairs 


10.3.6 Grid search for critical points 


TRHO (*)grid meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax 
xmin xmin xmax xmax  xstep xstep 
ymin ymin ymax ymax  ystep ystep 
zmin zmin zmax zmax  Zzstep zstep 


(*)grid 

If activated, the search is performed. Otherwise no search is undertaken. 

meth is the method for a CP search and can be either nr or ef type as specified in Section 
10.3.3. In this case, the Newton-Raphson method is strongly recommended unless looking for 
a specific type of CP in the cell volume to the exclusion of all others. (WARNING ! The grid 
search is very costly if the entire asymmetric unit is explored) 


(*)ail 
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If this keyword is activated (*ail) atomic interaction line (AIL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. Otherwise atomic interaction line lengths and termini 
are not evaluated. This option is very compute-intensive ! 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 
nstep determines the maximum number of EF or NR steps along each search 


nnb nnb 
The value of nnb defines the number of star of neighbours in the nearest neighbour analysis 
around each unique CP (of any kind) found. 


rmax rmax 

rmax is the maximum distance (A) from the CP, considered in the nearest neighbour analysis 
around each unique CP found (see nnb nnb above). rmax value may locally reduce the actual 
value of nnb. 


<grid specification> 

xmin xmin xmax xmax xstep xstep (fractional units) 

xmin xmax xstep determine the minimum, maximum and grid interval along crystal a-axis. 
ymin ymin ymax ymax  ystep ystep (fractional units) and 

zmin zmin zmax zmax  Zzstep zstep (fractional units) 

are similarly defined with reference to the crystal b and c-axes respectively. 


All three MUST be given and they must all start on a new line 


10.3.7 Profiles of p(r), V2p(r) and àz along the line joining two nuclei or two 
general points 


Profiles of p(r), V?p(r) and à are written to Fortran units 95, 96, 97, respectively. The units of 
p(r), V?p(r) and às are determined by the keyword (*Jau (see Section 10.1). 


TRHO (*)profile perstep n 
«profile specification» (Several of these may be given) 


(*)profile 
If activated, the search is performed. Otherwise no search is undertaken. 


perstep n 

Determines the percentage step s along A-B or a-b 
ifn=1 , s-0.01xRa4s(or Ra» ) 

ifn=100, s= 1xRa-p ( or Rap) 


«profile specification» On a new line ! It can be given in one of the following formats: 
(atom label toneighbor il... i(n) 
Profile along the line(s) joining the unique atom A with label label and its il..i(n) neighbour(s) 


(atom B), where i is the 'NEW' number in the 'Clusters around each of the unique atom' 
printing at the beginning of the TOPXD output. The profiling will only be performed if keyword 
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atom is activated (i.e., *atom). Repeat this line m times for the m unique atoms to be 
considered. 


(*)point | car | fra] x1 yl z1 x2 y2 z2 

Profile along the line joining two points a and b with coordinates (x1 y1 z1) and (x2 y2 z2), 
respectively. The coordinates are in Cartesian (A) (car) or fractional (fra) units. The profiling 
will only be performed if keyword point is activated (i.e., *point). Repeat this line n times for 
n point pairs. 


10.4 Topological Analysis of the Laplacian of Electron Density 


10.4.1 Auto critical point search within the concentration (or depletion) shells of 
unique atoms and/or non-nuclear attractors 


Usually the search is performed in the valence shell charge concentration (VSCC) of each 
selected unique atom. Yet, a suitable choice for the sphere radius (rstar parameter, see below) 
allows for a CP search in (any of) the depletion shells of the selected unique atom. 


TLAP (*)auto meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax ntheta ntheta nphi nphi 
«atom(s) specifications» (Several of these may be given) 
«NNA specifications» 


(*)auto 

If activated, the search is performed. Otherwise no search is undertaken. 

meth is the method for a CP search and can be either nr or ef type as specified in Section 
10.3.3. 


(*)ail 

If this keyword is activated (*ail) atomic graph line (AGL) lengths and termini are evaluated 
numerically for each unique (3,-1) CP. This is a compute-intensive option ! The AGL is the 
union of the unique pair of V(V’p) trajectories that originate at the (3,-1) —V’p CP and terminate 
at neighbouring (3,-3) - V/p CPs. 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 
nstep determines the maximum number of EF or NR steps for each search 


nnb nnb 
nnb is the number of stars of neighbouring atoms which are considered in the nearest 
neighbour analysis around each unique CP found. 


rmax rmax 

rmax is maximum sphere radius (À) used to determine the neighbouring atoms around each 
unique CP in the nearest neighbour analysis (see nnb nnb explanation). rmax may, locally, 
reduce the actual value of nnb 


ntheta ntheta nphi nphi 

CPs search is started from points located on the surface of a sphere, centered on the nucleus 
of a given unique atom or at the NNA location. The number of starting points is determined by 
the intervals ntheta, nphi chosen for the polar coordinates 0 and 9, respectively 


110 


Chapter 10 - TOPXD - Full Topological Analysis 


atom(s) specifications given in the following format (Note that this record may be repeated as 
many times as needed for unique atoms for which the CP search is desired. One may group in 
a single record those unique atoms that are characterized by equal rstar and nmax values) 


(*Jatoms labell...label(n) nmax nmax rstar rstar 
The CP search will only be performed if the keyword atoms is activated (*atoms). 


labell..label(n) 
Labels of unique atoms for which the CP search will be performed. 


nmax 
If nmax is nonzero and if the EF method is used, the search for each atom is stopped when 
nmax different CPs of the required type are found. Otherwise a normal search is undertaken 


rstar 

If rstaris zero, the default sphere radius is adopted in the CP search. The radius is taken to be 
equal to the distance from the nucleus to the spherical surface where -V?p attains its 
maximum value in the valence shell of the isolated atom. If rstar is nonzero, the the sphere 
radius is taken to be equal to rstar value (À) 


NNA specifications given in the following format (insert 1 record per each NNA): 


(“nna xx yy zz nmax nmax rstar rstar 

The CP search for this NNA will only be performed if the keyword nna is activated (*nna). 
xyz - Cartesian coordinates of the current NNA (A) 

nmax , rstar 

As above for (*)atoms 


10.4.2 Critical point search started from a given set of points 


TLAP (*)points meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax nmax nmax 
[(*)car | (*)fra] x y z (Several of these records may be given) 


(*)points 

If activated, the search is performed. Otherwise no search is undertaken. 

meth is the method for a CP search and can be either nr or ef type as specified in Section 
10.3.3. 


(*)ail 
As for Section 10.4.1 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 

nstep determines the maximum number of EF or NR steps along each search (use a very small 
number of steps in this case, say no more than 5-8, since the search is repeated 40 times, 
starting from 40 evenly distributed points along the line) 


nnb nnb 
As for Section 10.4.1 
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rmax rmax 
As for Section 10.4.1 


nmax nmax 
As for Section 10.4.1 


[(*)car | (*)fra] x y z 

This command starts on a new line! Starting point coordinates (x y z) in Cartesian (A) (ear) or 
fractional (fra) units. The search will only be performed if the car/fra keyword is activated (i.e., 
*car or *fra). Insert this record n times to start CP search from n starting points. 


10.4.3 Critical point search along the line joining two nuclei or two general 
points 


TLAP (*)line meth (*)ail (*)debug nstep nstep nnb nnb rmax rmax nmax nmax 
«line specifications» (Several of these line may be given) 


(*)line 

If activated, the search is performed. Otherwise no search is undertaken. 

meth is the method for a CP search and can be either mr or ef type as specified in Section 
10.3.3. It is recommended to use the Newton-Raphson search (mr) unless a specific type of 
critical point is being sought to the exclusion of all others. 


(*)ail 
As for Section 10.4.1 


(*)debug 
Activation of this keyword enables the debug printing during CP search 


nstep nstep 
nstep determines the maximum number of EF or NR steps for each search 


nnb nnb 
nnb is the number of stars of neighbouring atoms which are explored from any unique CP 
found. A nearest neighbour analysis of atoms around each unique CP is printed. 


rmax rmax 

rmax is maximum sphere radius (À) used to determine the neighbouring atoms around each 
unique CP in the nearest neighbour analysis (see nnb nnb explanation). rmax may, locally, 
reduce the actual value of nnb 


nmax nmax 
As for Section 10.4.1 


line specifications can be given in one of the following formats: 


(*)Jatom label toneighbor il... i(n) 

CP search along the line(s) joining the unique atom A with label label and its il..i(n) 
neighbour(s) (atom B), where i is the 'NEW' number in the 'Clusters around each of the 
unique atom' printing at the beginning of the TOPXD output. The search will only be 
performed if keyword atom is activated (i.e., *atom). 
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(*)point [car | fra] x1 yl z1 x2 y2 z2 

CP search along the line joining two points a and b with coordinates (x1 y1 z1) and (x2 y2 z2), 
respectively. The coordinates are in Cartesian (À) (car) or fractional (fra) units. The search 
will only be performed if keyword point is activated (i.e., *point). Repeat this line n times for n 
point pairs 


10.5 Evaluation of atomic and/or NNA basin properties 


The atomic and NNA basin integration part of TOPXD consists of the following 5 types of 
instructions: 


e General parameters 
ATBP params ... 


e Alternative method for ZFS search 
ATBP altguess ..... 


e Capture sphere specifications for all unique atoms (optional) 
ATBP spheres ..... 


e Instructions for integration of unique atoms (required) 
ATBP (*)atoms ..... 


e NNA(s) specifications, if present (optional) 
ATBP NNA ..... 


10.5.1 General Parameters 


ATBP params PhInSph phi ThInSph theta *SavSurf 


phi and theta parameters define the angular integration parameters INSIDE the p-sphere: 
number of ọ (phi) and 0 (theta) grid points. SavSurf, when activated, enables TOPXD to write 
out the lengths and coordinates of integrations rays to file rays.dat for visualization in 
VZ3D (see section 10.6.1). 


10.5.2 Alternative method for ZFS search 


Activating this set of (optional) instructions enables the alternative method for ZFS search, 
based on algorithms decribed in [132] and [133]. In addition to that, a second-order Runge- 
Kutta method is used when tracing the gradient paths instead of a Predictor-Corrector 
method. The advange of this method is that it can significantly improve the speed of ZFS 
search, but can result in less accurate ZFS’s if incorrect parameters are specified. 


ATBP altguess bigstep bigstep accur accur maxrint maxrint rmax rmax stepO stepO A a B b 


bistep (au) defines the size of the step along the integration ray with which the search for 
intersection of each integration ray and ZFS is performed. accur (au) is the final precision in 
ZFS determination in bisection method (NOTE : it overrides the accur parameter specified in 
ATBP atoms instructions). maxrint (au) defines the max distance along the integration ray 
which can be reached during the search for ZFS intersection. rmax (au) — radius which defines 
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the size of the cluster of neighbours when tracing the gradient paths. Parameters stepO, a and 
b determine the step size for tracing the gradient paths at each point according to the formula 
[133] : 


step = step0 - exp( a|cos (O) E 


where stepO (au), a and b are input parameters and o is the angle between two vectors: 
integration ray and the gradient of the density. 


10.5.3 Capture sphere specifications for unique atoms 


Although these instruction(s) are optional, it is strongly recommended to specify the capture 
spheres for all atoms as it should considerably reduce the program runtime. There is no limit 
on the number of ATBP spheres instructions. 


ATBP spheres label! rad1 .... label(n) rad(n) 


rad is the radius of a capture sphere (À) for unique atom with label label. rad should be 
generally taken equal to the distance from the nucleus to the nearest of the p(r) BCPs which lie 
on the Vp(r) zero-flux surface (ZFS), enclosing the atomic basin of the unique atom with label 
label. The default of 0.2 À is safe for almost all atoms, but is not computationally efficient. 


10.5.4 Instructions for integration of unique atoms 


This required instruction requests the integration of the atom basin(s) of unique atom(s). 
There can be as many lines with ATBP (*)atoms ..... instructions as the number of unique 
atoms. Note that this command MUST be entered all on one line ! 


ATPB (*)atoms label [izfs | zfs] nvi nvi irsur irsur (*Jirsav (*)rest (*)debug phi 
nphi th nth rad rad accur accur í nbcp nbcp [car | fra | } 


{.... if nbcp > O insert nbcp records with BCP x y z coordinates... ... H 


(*)atoms 
The activation of this keyword (*atoms) requests the integration of unique atoms specified 
with labelinstruction. If this keyword is not activated the integration will not be performed. 


label 
Specifies which atoms will be integrated if atoms keyword is activated (*atoms). 
There are several possible format specifications for label. 


1. Labels of unique atoms, for example: 
ATBP *atoms O(1) C(2) N(10) H(24A) ......... 
2. Keyword all for all unique atoms to be integrated, for example: 
ATBP *atoms all ......... 
3. Atomic symbols - all atoms with the same atomic symbols will be integrated, for 
example : 
ATBP *atoms O H ......... 
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izfs 
Indirect determination of the ZFS [134]. This is the recommended and more accurate method 
for determination of ZFSs, but is computationally rather demanding 


zfs 

With this method the determination of the ZFSs is achieved in two steps: 

e direct determination [135] 

e indirect determination [134] for those integration rays (IRs) whose length was not correctly 
recovered in step a) 

NOTE: The ZFS method is still experimental and has not been thoroughly tested. It may 

well fail ! 


nvi nvi 

nvi is the number of star of neighbours of the current unique atom(s) which have to be 
considered as possible attractors of the Vp(r) paths launched from points along the integration 
rays 


irsur irsur 

irsur= O-normal run 

irsur= 1- the lengths of the integration rays obtained in a previous run are read from Fortran 
unit 97 (file fort.97) and used as an initial guess for the IR's lengths 

irsur = -1 - the lengths of the integration rays are kept fixed to those obtained in a previous 
run and read from Fortran unit 97 (file fort .97). 


(*)irsav 

When activated the lengths of the integration rays are saved in Fortran unit 98 (file 
fort.98). NOTE: The use of irsur + O requires that *irsav was set in a previous ATBP run. 
The ZFS thus saved on Fortran unit 98 (file fort.98) may be used in a following run 
(irsurzO), by copying it on Fortran unit 97 (file fort.98). Use irsur= -1 to run the integration 
step separate from the ZFS determination step; put irsur - 1 to use the ZFS obtained in a 
previous run for a given unique atom (obtained, for example, using a different multipole 
model) as a starting guess for the new ZFS determination. 


(*)rest 
When activated the run is restarted from (partial) surface data stored in Fortran unit 96 (file 
fort. 96) from a previous aborted run 


(*)debug 
Activates the debug printing during the ZFS determination and integration 


phi nphi th nth 
Angular integration parameters outside f-sphere: number of o (nphi) and 0 (nth) grid points 
(see also FAQ section) 


rad rad 
rad is the number of radial integration points inside B-sphere 


accur accur 

Parameter accur (au) determines the numerical accuracy of each IR length and thus of the 
overall ZFS determination. The default value is 0.001 au. A larger accur value reduces the 
computational time at the expense of accuracy (see also FAQ section). 


( nbcp nbcp | car | atom |} 
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These optional parameters should only be used for a two-step procedure in ZFS determination 
(see keyword zfs above). nbcp is number of (3,-1) CPs associated with the atomic interaction 
lines (AIL) [see TRHO section] linking the current unique atom to other atoms and/or NNAs. 
The keyword car|atom determines the format for specification of (3,-1) critical points to be 
read in the following nbcp records (if nbcp > 0). 


1. Keyword car specifies that the Cartesian coordinates of a (3,-1) critical point should be 
given: 
{ x y z} 


2. Keyword atom specifies the atom linked to the current unique atom 
{ inum itx ity itz } 


inum is the sequence number of a linked atom in the TOPXD printing of all atoms in the unit 
cell, while itx ity and itz specify the indices (direct cell) of the cell where the linked atom 
inum is located. 


10.5.5 NNA(s) specifications 
Use this optional instruction if non-nuclear attractors (NNA's) are present in the structure. 


ATBP NNA nna 

nna 

nna is the number of NNAs in the structure. The default is zero, i.e. no NNA's. 

If nna > O insert nna records (starting on a new line) with NNA specifications in the following 
format: 


X X y y z z (*Jinteg sphere rad { [izfs | zfs] nvi nvi irsur irsur (*Jirsav (*)rest 
(*)debug phi nphi th nth rad rad accuraccur} ( nbcp ncp[car | fra] } 


{....ifnbcp > O insert are nbcp records with BCP x y z coordinates. .... H 


There should be as many lines with NNA specifications as the number of NNA's in the 
structure. 


XXyuyzz 
Cartesian coordinates of this NNA (À) 


(*)integ 
When activated, the integration of the basin of this NNA will be performed 


sphere rad 

rad is the radius of a capture sphere for this NNA (A). rad should be generally taken equal to 
the distance from the NNA to the nearest of the p(r) BCPs which lie on the Vp(r) zero-flux 
surface (ZFS), enclosing the NNA basin 

NOTE: The following keywords should only be used if keyword integ is activated 


izfs | zfs 
As for Section 10.5.4 


nvi nvi 
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nvi is the number of star of neighbours of the current NNA which have to be considered as 
possible attractors of the Vp(r) paths launched from points along the integration rays. 


irsur irsur 
As for Section 10.5.4 


(*)irsav 
As for Section 10.5.4 


(*)rest 
If this keyword activated the run is restarted from (partial) surface data stored in Fortran unit 
96 (file fort . 96) from a previous aborted run 


(*)debug 
Activates the debug printing during the ZFS determination and integration 


phi nphi th nth 
Angular integration parameters outside B-sphere: number of o (nphi) and 0 (nth) grid points 


rad rad 
rad is the number of radial integration points inside B-sphere 


accur accur 

Parameter accur (au) determines the numerical accuracy of each IR length and thus of the 
overall ZFS determination. The default value is 0.001 au. A larger accur value reduces the 
computational time at the expense of accuracy. 


{ nbep nbcp | car | atom ] } 
As for Section 10.5.4 


10.6 2-Dimensional (2D) Plots 


The 2D (and 3D) plot instructions have a slightly different format than others. The general 
format consists of the following sections: 


General instructions 

Specific plot instruction(s) (one instructions per each specific plot type) 
Instructions for creating HPGL graphics files from the plot data 
Visualization with hp2xx program 


PL2D general instructions apply to all the specific plot instructions PL2D plot until the next 
PL2D general is given and so on. There is no limit on neither the number of PL2D general nor 
PL2D plot instructions. Some of the TOPXD 2D plot files can also be visualized with program 
SURFER (a PC-DOS program for 3D plots) and XDGRAPH. 


10.6.1 2D plot general instructions 


This section MUST precede specific plot instructions. All parameters specified in this section 
will apply to the following specific plot instructions until the next general instruction section is 
given. 
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PL2D general 

point/atom A specification 

point/atom B specification 

point/atom C specification 

plotdim xmin xmin xmax xmax xstep xstep ymin ymin ymax ymax ystep ystep 
origin shift ish/t origin xo yo zo vmod vmod 

misc size ax scale scale name ‘name’ title ‘title’ 


The format is exactly as laid out above, i.e. each command starts a new line. See Chapter 12 for 
an example. 


point/atom A/B/C specification 
Three atoms or points (A,B,C) must be given to define the plot plane. The specification format 
is different for atoms and points: 


1. Atoms can be specified using the following format 

atom inum itx ity itz 

inum is the serial number of atom in TOPXD printout of all atoms in unit cell 

itx ity itz — translations applied to fractional coordinates of atom with number inum along X, Y 
and Z-crystal axis, respectively 


2. General points can be specified using the following format: 
point | car | fra] xyz 
where x y z are fractional (fra) or cartesian (À) (car) coordinates 


NOTE: If the evaluation of a molecular/crystal graph or, generally, of Vp(r) trajectories is 
required, it is important to define the three atom/points in such a way that their associated 
clusters of neighbouring atoms (see below) adequately spans the plot plane. 


plotdim xmin xmin xmax xmax xstep xstep ymin ymin ymax ymax ystep ystep 


The plot plane is XY. xmin and xmax define the minimum and maximum values along the plot 
X-axis, respectively, while xstep defines the grid interval along X. ymin ymax and ystep have 
the same meaning but for Y-axis of the plot. All these parameters must be given in Angstroms. 


origin shift ish/t origin xo yo zo vmod vmod 


ishift - O - origin as in the original Cartesian frame. A warning message is issued if, as a 
consequence of a given choice of the origin, the atoms/point A,B,C do not longer lie in the XY 
plot plane. 

-] - the origin of the plot is translated to a point lying on ABC plane (must specify the xo yo 
and yo coordinates, see below) 

= 2 — the origin of plot is put at mass-weighted centroid of the atoms/points, which define the 
ABC plane. A mass equal to 1 is assigned to any point in ABC plane definition. 

= 3 - the origin of the plot lies along the A-B axis and its actual position is defined by the value 
of vmod variable (see below) 

= 4 — the origin of the plot is at atom/point A 

= 5- the origin of the plot is in the centroid of the three atoms/points (as in XDGRAPH). 


xo yo zo — Cartesian (A) coordinates of the origin of the plot 
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vmod — the vmod value shifts the origin along A-B, so if vmod=0 the origin is at A and if 
vmod=1 the origin is at B; Negative vmod values as well as values greater then 1 are also 
allowed. 


misc size ax scale scale name ‘name’ title ‘titile’ 


ax = a4 - plot size is A4 
- a3 - plot size is A3 


scale — Plot scale (A/cm) 


‘name’ 

Suffix name enclosed in single quotes '' (maximum 24 characters, no blanks and no special 
symbols like *,",^ etc) for the files which contain the values of each computed function func 
(see below) and the common information for the XYZ plot (system geometry, Euler rotation 
angles from crystal to plot frame, plot size, etc.). These files form the input for the P2DCRY 
section. Full names of the files are listed in Table 10-1 below (‘//’ means character 
concatenation). Common information for the XY plot is saved in file: P2DCRYIN//name. The 
files prefixed with ‘SURF’ may also be read from the SURFER program (a PC-DOS program for 
representing the scalar function in the plot plane as a 2D surface in 3D space, something that 
it is often referred to as a 3D graph). 


‘title’ - Plot title enclosed in single quotes ' ' (maximum 80 symbols, blanks are allowed, no 


special symbols like ‘,”,” ). 


Table 10-1 
Scalar function (or Vp(r) plot) type Filename 
Electron density p(r) SURFRHOO/ / name 
Laplacian of p(r) V2p(r) SURFLAPP/ / name 
Negative of the Laplacian p(r) -V2p(r | SURFLAPM / / name 
Magnitude of the gradient of p(r) | Ve(r) | | SURFGRHO/ / name 
Vp(r) trajectories only TRAJGRAD/ / name 
Molecular/crystal graph (and atomic basin boundaries) MOLGRAPH/ / name 
Vp(r) trajectories and molecular/crystal graph TRAJMOLG/ / name 


10.6.2 2D plot specific instructions 


These instructions must follow the general 2D plot instructions. 
PL2D (*)func nstar nstar rmax rmax (*)test (*)cut cutr cutl (func-dependent instructions] 


Note: There is no limit for the number of PL2D plot.... instructions (one instruction per 
line). 


(*)func 
When activated, the function of one of the following types is plotted (the names of output files 
created are given in the description of 2D plot general instructions and in Table 10-1) 


*rhoo — electron density ( p(r) ) 
*lapp — Laplacian of the electron density ( V?p(r) ) 
*lapm - negative Laplacian of the electron density ( -V?p(r) ) 
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*grho — magnitude of the gradient of electron density ( | Vp(r)| ) 
*trajgrad — Vp(r) trajectories only 

*molgraph - molecular/crystal graph (and atomic basin boundaries) 
*trajmolg — Vp(r) trajectories and molecular/crystal graph 


nstar nstar 

nstar is number of star of neighbours used in cluster construction around A, B and C 
atoms/points. From these clusters the atoms lying (not lying) in the ABC plane are selected 
and their position denoted with *(+) in the plots. The nstar variable is also used in and 
determines: 

e Atom pairs considered in the evaluation of the molecular/crystal graph on the ABC plane 

e Number of origins (nuclei) for the downhill Vp(r) trajectories (gradient paths) on the ABC 

plane. 


rmax rmax 
rmax determines the maximum radius (A) of each cluster (see nstar variable) and may (locally) 
reduce the actual value of nstar 


(*)test 

If this keyword is activated (*test) the program stops after printing the coordinates of A, B, C 
and corresponding clusters of atoms in the plot frame. Use this option to check if the choice of 
the plane ABC was correct at the first run. 


(*)cut cutr cutl 
If the keyword cut is activated (*cut) the scalar functions of p(r) and |Vp(r)| are cut at the 
value of cutr and/or values of V?p(r) and -V?p(r) are cut at +cutl, according to their sign (cutr 
cutl must be given electrons and Angstroms). Cutting of the scalar function is generally 
required, especially in the case of the Laplacian, for representing the function in the plot plane 
as a 3D graph. 


Lfunc-dependent parameters in Plot 2D specific instructions } 
The exact instructions added next may depend on the function being plotted. 


10.6.2.1 func - trajgrad 
Add the following parameters to PL2D plot trajgrad ... instruction: 


toler toll tol2 (*)plane npath npath nextr nextr 
t if nextr > O add nextr lines with Cartesian (A) x y z of attractors Vp trajectories (one set per 
line) } 


An atom in the XY plot plane is considered as an origin of downhill gradient paths or as a 
terminus of an atomic interaction line if its distance from plot edge is less than toll (A) and its 
| z-plot coordinate | is less than tol2 (A). 


NOTE: A 'correct' tracing of Vp(r) trajectories in the plot plane would require this plane to be a 
mirror plane. However, this is not always the case. For example, in the study of molecular 
crystals at experimental geometries, it is common practice to deal with quasi-mirror planes. 
To cover such cases, Vp(r) trajectories are projected on the plot plane whenever their | z-plot 
coordinate | is less than tol2 (A). 

If keyword plane is activated (*plane) the starting point of each Vp(r) trajectory segment (which 
are typically 10- to 10-2 A long) is forced on the XY plane, while default is the normal tracing 
of Vp(r) trajectories (with projection regulated by tol2). 

The number of downhill Vp(r) trajectories is defined by variable npath (the recommended value 
for npath is 36 ). 
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Variable nextr defines the number of other attractors, like non-nuclear (NNA's) attractors or 
the 2D attractors associated with a BCP, to be considered as origins of downhill Vp(r) 
trajectories. A BCP is seen as a (2,-2) attractor whenever its associated ZFS lies in the plot 
plane. 

If nextr > O add nextr lines with Cartesian (A) x y z coordinates of attractors of Vp(r) trajectories 
(one set of x y z coordinates per line) 


10.6.2.2 func = molgraph 
Add the following parameters to PL2D plot molgraph ... instruction: 


tol toll tol2 (*)plane thr thr (*)tr1 (*)tr2 (*)tr3 


An atom in the XY plot plane is considered as an origin of downhill gradient paths or as a 
terminus of an atomic interaction line if its distance from plot edge is less than toll (A) and its 
| z-plot coordinate | is less than tol2 (A). 

NOTE: A 'correct tracing of molecular/crystal graphs in the plot plane would require this 
plane to be a mirror plane. However, this is not always the case. For example, in the study of 
molecular crystals at experimental geometries, it is common practice to deal with quasi-mirror 
planes. To cover such cases, Vp(r) trajectories associated to the molecular/crystal graph are 
projected on the plot plane whenever their | z-plot coordinate | is less than tol2 (A). 

If keyword plane is activated (*plane) the starting point of each Vp(r) trajectory segment is 
forced on the XY plane, while default is the normal tracing of Vp(r) trajectories (with projection 
regulated by tol2). 

The maximum distance between atomic pairs, which is taken into account during the 
evaluation of bonded pairs and the automated tracing of the molecular/crystal graph, is 
defined by the value of thr (A). 

The Vp(r) trajectories that originate at BCPs and have as initial direction the K-th eigenvector 
of Hessian of p(r) at BCPs, are traced out ( *trK ) or skipped ( trK ). The K-th eigenvector is 
associated with the K-th eigenvalue of the Hessian Xx (A1 <A2 € Az). 


10.6.2.3 func = trajmolg 
Add the following parameters to PL2D plot trajmolg ... instruction: 


tol toll tol2 (*)plane thr thr (*)tr1 (*)tr2 (*)tr3 npath npath nextr nextr 
{ if nextr > O add nextr lines with Cartesian (A) x y z of attractors Vp trajectories (one set per 
line) } 


An atom in the XY plot plane is considered as an origin of downhill gradient paths or as a 
terminus of an atomic interaction line if its distance from plot edge is less than toll (A) and its 
| z-plot coordinate | is less than tol2 (A). 


NOTE: A 'correct' tracing of Vp(r) trajectories in the plot plane (including those associated to 
the molecular/crystal graph) would require this plane to be a mirror plane. However, this is 
not always the case. For example, in the study of molecular crystals at experimental 
geometries, it is common practice to deal with quasi-mirror planes. To cover such cases, Vp(r) 
trajectories are projected on the plot plane whenever their | z-plot coordinate | is less than 
tol2 (A). 

If keyword plane is activated (*plane) the starting point of each Vp(r) trajectory segment is 
forced on the XY plane, while default is the normal tracing of Vp(r) trajectories (with projection 
regulated by tol2). 
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The maximum distance between atomic pairs, which is taken into account during the 
evaluation of bonded pairs and the automated tracing of the molecular/crystal graph, is 
defined by the value of thr (A). 

The Vp(r) trajectories that originate at BCPs and have as initial direction the K-th eigenvector 
of Hessian of p(r) at BCPs, are traced out ( *trK ) or skipped ( trK ). The K-th eigenvector is 
associated with a K-th eigenvalue of the Hessian Ax ( À1 < A2 € Aa. 

The number of downhill Vp(r) trajectories is defined by variable npath (the recommended value 
for npath is 36). 


Variable nextr defines the number of other attractors, like non-nuclear (NNAs) attractors or 
the 2D attractors associated with a BCP, to be considered as origins of downhill Vp(r) 
trajectories. A BCP is seen as a (2,-2) attractor whenever its associated ZFS lies in the plot 
plane. 

If nextr > O add nextr lines with Cartesian (A) x y z coordinates of attractors of Vp(r) trajectories 
(one set of x y z coordinates per line) 


10.6.3 Converting TOPXD 2D plot data to HPGL graphics format 
P2DCRY (*)diff varl var2 var3 
(*)diff - activate for difference plots only 


For a difference plot: 

varl - function type to plot, i.e. rhoo, lapp or lapm 

var2 - name of the first file (from PL2D general instruction) 
var3 - name of the second file (from PL2D general instruction) 


Otherwise: 

varl - name of the file (from PL2D general instruction) 

var2 - function type to plot, i.e. one of the following: rhoo (p), lapp (V2p), lapm (-V?p), grho 
(|Vp|), trajgrad (Vp(r) trajectories), molgraph (molecular ghraph), trajmolg (molecular graph 
and Vp(r) trajectories), rhoomolg (p and molecular graph), lappmolg (V?p and molecular 
graph), lapmmolg (-V?p and molecular graph). 


10.6.4 Visualisation of 2D plots with program hp2xx 


The HPGL graphics files created by TOPXD can be visualized or converted to some other 

graphics formats by program hp2xx (part of GNU software), which can be downloaded from: 
http:/ / www.gnu.org/ software/ hp2xx/ hp2xx.html 

At this time the latest version of hp2xx is 3.4.3 (2003/01/07). 


NOTE: Some of the newer versions of hp2xx have been reported to have problems with 
TOPXD files !!! In this case, please download one of the older versions. 


Once the hp2xx is installed, the HPGL file created by P2DCRY2000 can be visualized in 
graphical display using command: 


hp2xx «name of HPGL graphics file from P2DCRY2000> 
For better resolution one can use -d dpi value option, i.e. the command: 


hp2xx «name of HPGL graphics file from P2DCRY2000> -d 300 
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will display an image with 300 DPI rasterization. 


In order to change the thickness of the lines in the image one can use the -p option, which 
controls size (in pixels) of the virtual plotting pen. There are total 8 pens simulated. Each pen 
can be assigned a different size. Thus the command: 


hp2xx «name of HPGL graphics file from P2DCRY» -p 43568111 


requests size 4 for pen 1, size 3 for pen 2, size 5 for pen 3, size 6 for pen 4, size 8 for pen 5, 
and size 1 for pens 6,7 and 8. 


It should be noted that TOPXD uses different pens to draw different objects in the 2D drawing. 
The assignment of pens is as follows: 


Pen number Corresponding object in the drawing 
1 contours (and Vp(r) trajectories) 

dash lines 

BCP position 

bond path 

nuclear positions 

plot info and border 

atomic basin boundaries 

not used 


0 -1Oo 014 CQ IN 


Each pen can also be assigned a different colour using the option -c. The use of this option is 
similar to that of -d, i.e. for each pen one has to specify a colour number instead of a size. The 
colour-coding scheme is as follows: O=off, 1-black, 2=red, 3=green, 4=blue, 5-cyan, 
6=magenta, 7-yellow. Thus, the command: 
hp2xx «name of HPGL graphics file> -c 276431 

will produce a plot with pen 1 (contours, if any) being drawn in red colour, pen 2 (dashed 
lines, if any) in yellow colour, pen 3 (BCP position, if any) in magenta, pen 4 (bond path, if any) 
in blue, pen 5 (nuclei positions) in green, pen 6 (plot info and border) in black colour. 


hp2xx also provides an option (-r rotation angle in degrees) to rotate the object (image) prior 
to all scaling operations. Thus, the command -r 90 rotates the entire picture on 90°, 
converting from portrait to landscape format and vice versa. In general, any reasonable 
rotation angle is valid. 


In addition to visualization, hp2xx also provides an option to convert HPGL graphics file to 
more common and more supported vector and/or raster formats. There two options which 
control the output format type (-m format) and output filename (-f filename). 


From vector formats the most useful is the PostScript (-m eps) 


From raster formats the most useful is probably PCX (-m pex) since the image in this format 
can be easily inserted into Microsoft Word documents without any modifications. The example 
of a PCX image is shown in Figure 10-1 The image was created with the following hp2xx 
instruction: 


hp2xx PL2Dform -d 150 -p 218282 -c 276411 -f form.pcx -m pcx -r 270 


where PL2Dform is the name of the P2DCRY output file and form.pcx is the 
hp2xx output PCX image. 
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There are many other useful options provided in hp2xx program. Please refer to hp2xx 
manual pages for more information. 


For Windows users, the free software PRINTGL is available for viewing HPGL files. See 
http:/ / www.concentric.net/ ~ravitz/ 
This has many of the features discussed above for hp2xx 


Figure 10-1 p(r) trajectories and molecular graph of formamide molecule in the crystal 
created from TOPXD/P2DCRY2000 data with hp2xx. The Vp(r) trajectories are shown 
with red lines, nuclear positions are marked with + (black), BCPs are marked with o 
(magenta), bond paths are shown with blue lines. 


TOPXD rules !!!!!! GradRho Traj 
Xlen (cm) Ylen (cm Xine (cm) Yinc Cem) Scale (Ang/cm) 
12.50 10.00 0.25 0.25 0.40 


CNR Center for the Study of Structure/Reactivity Relations - Milano - Italy 


10.7 3-Dimensional (3D) plots 


The 3D plot section concerns the evaluation of a number of scalar functions on a 3D grid. The 
data so obtained may be used for 3D representations of specific envelopes of the scalar 
function. 
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The 3D plot instructions have the format, which is quite similar to 2D plots. The general 
format consists of the following two sections: 

e General instructions 

e Specific plot instruction(s) 


The PL3D general instructions apply to all the specific plot instructions PL3D plot until the 
next PL3D general is given and so on. There is no limit on neither the number of PL3D general 
nor PL3D plot instructions. 


As of this version, TOPXD writes all 3D grid files in XDGRAPH format if plot is defined in 
Cartesian coordinate system, as well as in SciAn [136] input formats. 


10.7.1 3D plot general instruction section 


This section MUST precede specific plot instructions. All parameters specified in this section 
will apply to the following specific plots until the next general instruction section is given. 


PL3D general [car | fra | 

xmin xmin xmax xmax xstep xstep 
ymin ymin ymax ymax ystep ystep 
zmin zmin zmax zmax zstep zstep 
name ‘name’ 


The format is exactly as laid out above, i.e. each command starts a new line. See Chapter 12 for 
an example. 


xmin xmax xstep 
Minimum and maximum values and grid interval along the crystal X-axis (fra) (in fractional 
units) or cartesian X-axis (car) (in Angstroms). 


ymin ymax ystepb zmin zmax zstep 
These are similarly defined along the Y-axis and Z-axis respectively 


name ‘name’ 

Character variable name included in single quotes '' (maximum 24 characters, no blanks and 
no special symbols like ‘,”,“ etc ) defines the part of the name of files containing the values of 
each computed function func (see 3D plot Specific Instructions ). Full names of the files are 
listed in the table below ('//' means character concatenation). 


File names 


Scalar function type 
SciAn SY format SciAn STF format XDGRAPH format 


Electron density p(r) 3DRHOO//name | 3DRHOO//name//.stf| 3DRHOO/ /name/ / .grd 


Laplacian V?p(r) SDLAPP/ / name SDLAPP/ / name/ /.stf | SDLAPP/ /name/ / .grd 


Negative of the 
Laplacian -V?p(r) 
Magnitude of the 

gradient Vp(r) | 


SDLAPM / / name SDLAPM/ / name/ /.stf| 3DLAPM/ / name/ / .grd 


SDGRHO/ / name | 3DGRHO/ / name/ / .stf, 3DGRHO/ / name/ / .grd 
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10.7.2 3D plot specific instructions 


These instructions must follow the general 3D plot instructions. 
PL3D (*)plot func(1)... func(n) 


NOTE There is no limit for PL3D plot.... instructions and number of func instructions in each 
line, except the 256 character string limitation in the latter case. 


(*)plot — If activated (*plot) plot specified functions (see below) 


func(1)...func(n) - function type(s). The following function types are recognized: 
rhoo -electron density ( p(r) ) 

lapp  -laplacian of the electron density ( V?p(r) ) 

lapm -negative laplacian of the electron density ( -V?p(r) ) 

grho - magnitude of the gradient of electron density ( | Vp(r)| ) 


10.8 3-Dimensional (3D) visualization of atomic basins 


As of this version, TOPXD contains options for 3D visualization of atomic basins in XDGRAPH 
from the results of atomic basin integration (see Section 10.4). If the keyword SavSurf in 
ATBP Params directive (see Section 10.4) is flagged, then during the determination of ZFSs 
the integration ray data are saved to file rays.dat for each integrated atom. The VZ3D 
section provides the interface to XDGRAPH for visualization of that data. 


VZ3D (*)plot 

files file(1) file(2) ... file(n) 

basins label(1) label(2) ... label(n) 

range (*)default xmi xmi xma xma ymi ymi yma yma zmi zmi zma zma 
grid (*)default dx dx dy dy dz dz rvec (*)default rvec 

END VZ3D 


The format is exactly as laid out above, i.e. each command starts a new line. See Chapter 12 for 
an example. 


files file(1) file(2) ... file(n) 

Names of files from which the integration ray data will be read. If integration of all atoms for 
which the basins will be plotted was done in one directory, then only one rays.dat file 
should be specified. If integration of atoms was done in separate directories and/or on 
different computers, then files rays.dat should be renamed and specified one by one in this 
instruction. 


basins label(1) label(2) ... label(n) 

Labels of unique atoms for which the basins will be plotted. The integration ray data for these 
atoms should be present in one of the files read with files directive, otherwise the atom will be 
ignored. 


range (*)default xmi xmi xma xma ymi ymi yma yma zmi zmi zma zma 

Definition of limits of the Cartesian grid (in À) generated for visualization in XDGRAPH. If 
keyword default activated (*default), these limits will be automatically determined based on 
the data read from all files specified in files directive. 
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grid (*)default dx dx dy dy dz dz rvec (*)default rvec 

Definition of the grid spacings dx dy and dz of the Cartesian grid (in A). If keyword default is 
activated (*default), the default value of 0.1 A will be used for for dx dy and dz. Parameter 
rvec specifies the radius of the sphere (in A) centered on each grid point. If the boundary of 
the atomic basin lies within the rvec A from the grid point it is assumed that this grid point 
also belongs the atomic basin boundary. 


Output 3D grid file from VZ3D section of TOPXD basin.grd can be readily visualized in 
XDGRAPH. 


Atomic basin of O(1) atom in methyl carbamate 
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10.9 Description of atomic properties evaluated by TOPXD 


Populations 
Atomic population N N(O)-lop(r) dt 
Net charge Q q(Q)=Z(Q) -N(Q) 
Energies 


Atomic Lagrangian (the error in Lis a 


measure of the accuracy of the|L L(Q)= -1/4JoV2pdt 
numerical integration) 
Atomic value of  nuclear-electron 
potential energy with its own nucleus; VNEO VNEO(Q)=-Jo(Zo/ro)p(r)dt 
Ro is the position vector of Q in the ro-r-Ro; ro- ral 
system frame 
Atomic Forces 
AXA(Q)= 3 

Atomic force components FAXA 5 (2) lo(Za /r*o)xop(r)de 

FAYA(O)-lo(Zo /r3o)yop(z)d: 
Force on nucleus of atom Q by the FAYA FAZA(Q)=Io(Za /r? nd 
electron density of atom Q FAZA (2)“Jo(Za /1%a)Zaplr)dr 


Xo,Vo,Zo , XYZ comp. of To 


‘Radial’ Atomic expectation values 


molecule or in a crystal) is equal to 


-3N(Q) 


R(-1) 
Atomic expectation value of the operator R 
B R(+2) R*(O)-[ar"o ple)de 
i R(*3) 
R(*4) 
Atomic expectation values of ro 
averaged over roeVp(r). It reflects the 
distortion of theVp(r) field of the charge | GR(-1) 
density that is caused by the formation | GR( 0) Brie 
of pecs bond. For 2 and for a free | GR( 1) GR'(O)-Íor"ro «Vp(z)ds. 
atom (or a perfectly spherical atom in a | GR( 2) 


Atomic volumes 


and related 


populations 


Volume of the region of the atomic basin 


vool (Q)=Jedto.001 
where dto.001 are the infinitesimal 


where p(r) is greater or equal 0.001 au yoo? volume elements where p(r) exceeds 
or is equal to 0.001 au 

Electron population in the VOO1 region NOO1 N001(Q)=Ja p(r)dt0.001 

Ratio of electron populations in VOO1 R001 ROO1=NO01/N 

and in the atomic basin 

Volume of the region of the atomic basin » 

where p(r) is greater or equal 0.002 au bid V002(2)=lndto.00 

Electron population in the V002 region N002 N002(0)-[o p(r)dto.oo» 

Ratio of electron populations in V002 R002 ROO2=N002/N 

and in the atomic basin 

Total atomic volume VTOT VTOT(Q)=Jodt 
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Atomic unambridged moments 


DX(Q)= -Jop(r)xodt 


DX 
is E DY(Q)= -Jop(t)yodt 
Atomic dipole components uu DZ(Q)--fop(z)zad: 
Xo,Yo,Zo i XYZ E of ro 
NS ; DM(Q)= | DM(Q) | where 
ORO ep Ole cence di Pu is Ds ien dipole vector 
Lene of atomic displacement es ced i mee s n 
DCZ DCZ= - DZ/N(Q) 
CX CX= DCX+Xo 
Coordinates of the centroid of negative | CY CY- DCY+Yo 
charge CZ CZ= DCZ*Zo 
Xo,Yo,Zo, xyz components of Ro 
QXX QXX(Q)= -lo xo?p(z) de 
QXY QXY(Q)= i Xoyop(r) dt 
. ia QXZ QXZ(Q)= -Jo Xo Zop(r) dt 
Atomic 2"? moment tensor components QYY OYY(Q)= - ia yo? p(t) dt 
QYZ QYZ(Q)= -lo yo zop(z) dt 
QZZ QZZ(Q)= -lo zo? pl) dt 


Eigenvalues and eigenvectors of the 
atomic 274 moment tensor 


Atomic 3rd moment tensor components 


Atomic 4t moment tensor components 


Atomic Shannon information entropy 


atomic information (missing information 
function): is the integral of p'Inp' where 
p' is the un-normalized electron density 
(IUN) or the normalized electron density 
to unity over the atomic basin (INO) 
[137] 


IUN 
INO 


1(Q)= - fo p1np'd« 
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10.10 Frequently Asked Questions 


Q: When should I use the Newton-Raphson (NR) and when the Eigenvector Following (EF) 
method? 


A: In general NR is only suitable for the location of a critical point if one is already in a region 
where the Hessian of p(r) has the correct structure [128]. Thus, NR will fail to find a ring 
critical point if the starting point has the same eigenvalue signs as a bond critical point. The 
EF method has proved to be much less sensitive to the choice of good starting search points. 
The EF method, in practice a NR method with a suitable and locally defined shift for the NR 
step, seeks for the CPs of a given type, independently on the structure of the Hessian at the 
starting point. This is particulary important in the case of the V?p(r) field, since this scalar 
function varies quite rapidly. 


Q: When integrating an atomic basin with TOPXD I get the following error message: 
PATHE2: OSCILLATION OF PATHS 

PATHE2: THE ATTRACTOR OF THIS PATH WAS PROBABLY NOT INCLUDED IN THE 
CLUSTER 


A: Check the list of atoms reached in the feeler rays determination step. If you think that some 
neighbouring atoms were missed, you may have to increase parameter nvi in order to include 
the missing atoms into the list of possible attractors of the Vp(r) trajectories. Once you have 
used a very large nvi value, leave your calculation to try to end its task (even if the message 
appears many times). 


The OSCILLATION OF PATHS message may also appear in some cases where the integration 
will be anyhow successful. In many instances it represents just a warning. Especially, if you 
noticed that the list of neighbouring atoms (after the feeler ray step) corresponds to your 
expectations. 


Q: What grid should be used for integration of atomic basins and how does it affect the 
computing time ? 


A: In order to obtain satisfactory results you should use something like: 


64x48x120 (px0xradial) for non-H atoms 
32x24x96 (px0xradial) for hydrogen atoms (if not involved in H-bond) 
48x32x96 (px0xradial) for hydrogen atoms (if involved in H-bond) 


Note that the number of angular points and of radial points refers to the integration within 
beta sphere and outside beta sphere, respectively. 

Computing time is roughly proportional to no x n0. The number of radial points is very 
important for the precision, but hardly affects the total integration time, as it is operative only 
in the integration step and NOT in the ZFS determination (which takes about 95% of the total 
time). 


Q: Integration of an atomic basin takes a very long time. What options do we have to 
speed up the calculation ? 


A: Unfortunately the integration step is very very long (especially the ZFS determination which 


takes about 9596 of this time). You can try with the other proposed method, which is much 
faster but often fails. 
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Using the indirect method you can save some time by decreasing the accuracy of the surface 
determination. It is set as a default to 0.001 (see parameter accur) 

You could try to increase it up to 0.003 (no more than 0.005). You lose somewhat in precision, 
but you certainly increase in speed. You could compare the results of these two computations 
on one of the atoms you have already integrated, N(Q), L (Q), etc. using: 

1. first test : 64x48x120 accur =0.001 

2. second test: 64x48x120 accur =0.003 

Then you can decide if it is worth varying such a parameter and how much you can vary it. 


Q: How do I check the accuracy of the integration ? 


A: Check the value of the integrated Lagrangian. For an 'exact' integration it should vanish (for 

the divergence theorem). In practice: 

1. it should be less than 5x10- for H atoms, possibly around 1x10-5. A value of 1x10-+ could 
be perhaps acceptable, but not too precise. 

2. for second row atoms (C,N,O, etc) it should not exceed 1x10-3. Possibly 1x10~+ 


Q: You've mentioned that the computing time increases by a factor of 9x0 planes, but 
how does the nvi parameter affect the elapsed time? 


A: It will affect it, but in a very limited way, especially after the feeler ray step. Indeed the 
atoms reached during the feeler ray step are put at the top of the list of the nvi reachable 
atoms. So that the DO loop in PATHEN and PATHEN2 (these DO's run on the 3 x nvi x 
star multiplicity coordinates of the possible Vp(r) attractors) are in most cases (>99%) 
terminated much before the end of the loop. 

In practice you shouldn't notice a CPU time increase with nvi increase. Rather you could 
notice a decrease, if you have added an attractor that had to be enclosed. In this case the path 
oscillation is avoided and CPU time considerably saved. 


Q. Sometimes I have problems with the integrated Lagrangian, which stays above 1-10 
despite the fact that I use accur-0.001 and noxn0 as large as 96x64. I remember that 
you've mentioned that decreasing the number of points might help, but when I reduce 
these numbers to 48x32 or 64x48 it still doesn't help. These problems usually occur 
with carbon and nitrogen atoms, never with oxygens or hydrogens. What do I do ? 


A: What about electroneutrality? Are you very far from it ? The fact that one may get problems 
with carbon or nitrogen atoms and never with oxygen or hydrogen atoms seems to indicate, 
that the former have more complicated ZFS's than the latter (at least in the systems you are 
presently investigating). You could try to solve such a problem, by increasing the radius of the 
beta sphere for such atoms, thus reducing the size of the remaining part of the atomic basin. 
You could use for the beta sphere something like the distance of the closest BCP multiplied by 
1.15 (the program then reduces this number by 20%). Furthermore, the increase (inside the 
code) of the number of theta and phi points in the inner beta sphere might help. Please 
contact us and we will send you instructions on how to do it... 
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Chapter 11 
XD Utility programs 


11.1 XDVIB1 - A Program to Calculate the Mean-Square 
Displacement Amplitudes from Harmonic Vibrational 
Frequencies and Normal Modes. 


11.1.1 Overview 


The XDVIB programs described in this chapter were developed to improve the significance of 
the ADP’s obtained by LS refinement against X-ray data. This can be done by incorporating 
independent information based on spectroscopic and/or theoretical calculations into the 
refinement in terms of constraints or restraints. 


A full description of nuclear motion in molecular crystals, within the mean-field 
approximation, is an M-parameter problem, where M is the number of elements of the 
symmetric mean square displacement amplitude matrix to be derived (M=3N(3N+1)/2, N being 
the number of nuclei in the molecule). This is a hopeless task given the fact that even in an 
optimal case, only 6N ADP’s are available from a diffraction experiment. Consequently, further 
approximations and independent data are needed. A feasible approximation is to neglect the 
coupling between relative motion of the nuclei (internal modes) and the overall motion of the 
molecule in the lattice (external modes, 3 translation and 3 rotation) yielding a reduction in 
the number of free parameters by 6n, where n is the internal degree of freedom (n=3N-6 for 
nonlinear and 3N-5 for linear molecules). The knowledge of harmonic frequencies alone would 
further reduce the number of unknowns by N. A complete knowledge of the internal 
vibrational modes, including the frequencies, (n(n+1)/2 elements of the corresponding MSDA 
matrix) leads to m=21 (6x7/2) parameters to be derived (m « 21 form molecules composed of N 
< 8 atoms). However, to estimate 6N ADP’s (the diagonal, symmetric blocks of the total MSDA 
matrix) only 6N-m independent parameters, associated with internal modes are needed. But 
how to chose these remaining parameters? 


Upon neglecting internal-external coupling, each ADP can be given as a sum of two terms: 


U =V,+W, 


where V, and W, are the MSDA tensors (ADP’s) of atom a corresponding to the internal and 
external modes, respectively. The latter term can be adequately accounted for in terms of the 
m parameters of the T,L and S tensors of the rigid-body model [1]: 


W, -R,LR,-R,S«-SR,-«T 
where Ra is an antisymmetric tensor representing vector product 
0-952. 
R, =| y,0-x, 


—Z,x,0 
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with xa, ya and Za being the Cartesian coordinates of nucleus a situated at position fra. 


Since V4 and W, are additive, they cannot be obtained independently via an LS refinement, 
but they different behaviour upon a special transformation ca be used as extra information. It 
can be easily shown that the difference MSDA corresponding to W (the difference of the 
components of Wa and W» along the internuclear vector dab=rp-ra) vanishes for all a-b links: 


ACW) a» = d,, (W, ~ W, )d,, = 0 


but does not necessarily for V. This property of the internal ADP’s can be imposed as a 
restriction in the LS fit. Let’s suppose we know V, for all atoms, start the refinement with 
these values and constrain the shifts in the ADP’s according to the above requirement for a 
certain number of independent links: 


A(8U),, = 0 
After the k-th cycle we obtain 
UV =v, +8UV, UP =Vv,+8U" with A(U9), - A(V),, 


Thus, the information on the intermolecular vibrations are preserved during the refinement. 
There are I=N(N-1)/2 links. Singular value decomposition of the matrix of constraints 
eliminates linear dependencies, yielding, in general, 6N-m independent constraints. 


XDVIB1 calculates MSDA's (the total 3Nx3N V matrix) from n frequencies and normal modes 
obtained by the Gaussian program package. Details of the vibrational analysis implemented 
into Gaussian are described in [2]. There is an important point to make concerning these 
calculations. Harmonic vibrational analysis based on theoretical force fields is valid only if the 
gradient of the electronic energy with respect of nuclear coordinates vanishes (equilibrium 
geometry) and the force-constant matrix (the Hessian of the energy or the second derivatives) 
is taken at the equilibrium configuration. Thus the molecular geometry used in the vibrational 
analysis must be optimized at the same level of theory utilizing the same basis set that the 
derivation of the frequencies is based on. 


Gaussian works in terms of mass-weighted generalized coordinates to separate the internal 
(vibration) and external (translation and rotation) motion. The internal coordinates v (n-vector) 
are generated to be orthogonal the external ones, w (6-vector related to the Eckart 
coordinates). The output displays the wavenumber (ui, the reduced mass (pi) and the 
normalized Cartesian displacement vector for each normal mode (qi). The MSDA matrix is 
diagonal in terms of normal coordinates [3] 


«qq >= diag(5,,5,,5,,---,5,) 
ô, = d com As. 
81 “cv, 2kT 


«vv >=V=L<qq>L , q= Lu 


where 


while in Cartesian representation 


134 


Chapter 11 - XD Utility Programs 


11.1.2 Files used and created by XDVIB1 

Input: xd.mas, Gaussian frequency output 
Output: xd_vibl.par, xd_vibl.sig xd_vibl.out 
1.1.3 Input instructions for XDVIB1 


11.1.3.1 SELECT 
SELECT temp 100 scale 1. (*)nonlin linear 


temp temperature 
The temperature (K) maintained during the data collection. 
scale scalefactor 


A number used to scale the calculated frequencies (wavenumbers [cm-t], printed on the 
Gaussian output, GOUT). Frequencies calculated at different level of theory and basis set are 
scaled by empirical factors to eliminate known systematic errors. Selected values taken from 
reference [2] are listed below. If experimental normal frequencies (corrected for anharmonicity) 
are available, one can scale the calculated ones directly to those observed. 


Method /basis Scale factor Method /basis Scale factor 
HF/3-21G 0.9085 HF/631-G(d) 0.8928 
MP2(Full)/6-31G(d) | 0.9427 MP2(FC)/6-31G(d) 0.9434 
SVWN/6-31G(d) 0.9833 BLYP/6-31G(d) 0.9940 
B3LYP/6-31G(d) 0.9613 


11.1.3.2 MODES 

MODES (*)all frqmin frqmin frqmax frqmax 
IMODES include 1 2 3... 

IMODES exclude 1 23... 


By these commands the vibrational modes used in the ADP calculation are selected. Only one 
type of MODES command is allowed. 


all 

The default option includes all normal modes. 

frqmin frqmin frqmax frqmax 

If the command is stared, wavenumbers in the range of frqmin < v < frqmax are included. The 


default upper cutoff value of 1500 cm! limits the calculation to ‘soft’ (large- amplitude) modes. 


include / 23... 
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The normal modes are listed on the GOUT file in order of increasing wavenumbers. The 
include command allows for selecting a set of normal modes according to their order number 
on the list. Those not listed in the command line, will be ignored. 


exclude 123... 


The listed modes will be excluded. For the MODES command with include or exclude options 
more than one line can be entered (but not mixed)). 


11.3.2.3 DATAFILE 
DATAFILE *gaussian filename orient *standard 


This command will be used to identify different files containing the calculated vibrational data. 
*gaussian filename 


The only type of data file allowed in the present version of XDVIB1 is a gaussian type output 
file, (GOUT) . Its name is given as a character string filename. 


orient *standard input 


Atomic positional coordinates corresponding to the standard orientation of the molecule (the 
origin is place at the molecule’s center of nuclear charge) are used. 

If the coordinates are read from the checkpoint file of a previous geometry optimization, they 
are listed as Input Orientation’ of the GOUT file of the frequency job. In this case the input 
option should be flagged. 


11.2 XDVIB2 - A Program to Transform ADP's from Cartesian 
Systems to the Crystal Frame. 


11.2.1 Overview 


As mentioned above, the internal ADP's (Vi) calculated by XDVIB1 refer to the equilibrium 
molecular geometry. The conformation of the optimized molecule can considerably differ from 
that found in the crystal (experimental conformation). However, the comparison of Aa values 
corresponding to short links in structural analog molecules reveals only moderate 
conformational dependence. For bonds formed by atoms of comparable nuclear mass, A is 
invariant under rotation about the bond vector. 1-3 links show similar transferability. This 
local symmetry of the ADP’s is made use of when they are transformed from Cartesian 
(optimized molecule) to the crystal (experimental frame) coordinate system. 


The procedure starts with generation of atomic local frames defined in the same way as for the 
spherical harmonics in the multipole model. XDVIB2 does that automatically, using the 
atomic connectivity of the input molecule or fragment. The calculated ADP’s are than 
transformed into the local frames 


V, = M,V,M, 
where M, is an orthogonal 3x3 matrix whose column vectors are the components of the local 


basis vectors in the Cartesian system. The same transformation is applied to the experimental 
ADP’s : 
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U, = N,OD,O"N, 
where N, is based on the local connectivity of the experimental geometry transferred to a 


Cartesian system via the matrix O. In the last step the calculated ADP’s are transferred to the 
crystal frame 


V, = P;'V,P, P, =N,O 
The program prints out the full A(V) matrices in both representation (Cartesian and crystal). 


Their comparison can suggest a possible model for the segmentation that is applicable to the 
molecule during the LS refinement. If 


Aw (V) = Aw (V) 


for all links, the application of a full set of independent rigid-link constraints is feasible. 
Otherwise, the user should try to identify rigid groups and limit the constraints to intra-group 
links. The former approach corresponds to a rigid-body, while the latter to a segmented rigid- 
body model refinement. 


11.2.2 Files used and created by XDVIB2 


Input: xd.mas, xd vib2.inp, xd.inp 
Output: xd vib2.res, xd vib2.out 


11.2.3 Input instructions for XDVIB2 


There are no input instructions for XDVIB2. The program reads the xd vib2.inp file 
containing the Cartesian atomic parameters (as calculated and output by XDIB1) for as many 
molecules or atomic groups as many is needed to build the unit cell. The molecules are 
separated by a GROUP command line. Let's suppose there are two independent molecules in 
the unit cell and we completed the two Gaussian calculations, each followed by an XDVIB1 
run. The xd vibl.par files obtained for the two calculations can than be merged to create 
the xd vib2.inp files. Since the Cartesian-crystal transformation is done through the local 
systems, the parameters of the different groups can be given in different (but orthogonal) 
frames. This makes it easy to build a database of calculated ADP's 


References for XDVIB 


[1] Schomaker, V. and Trueblood, K.N. Acta Cryst. (1968) B54, 507. 

[2] Ochterski, J. W. Vibrational Analysis in Gaussian (1999) help@gaussia.com 

[3] Cyvin, S.J. Molecular Vibration and Mean Square Amplitudes, Amsterdam: 
Elsevier, 1968. 
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11.3 XDCIF - A Program to Create an Archive CIF 


XDCIF is a program to combine the CIF's produced by XD into an archive CIF called 
xd_archive.cif, which is suitable for submission to journals or deposition databases. 
Currently XD programs write the following CIF's - xd_lsm.cif, xd_fft.cif and 
xd geo.cif.  XDCIF will load these files (if found) and, with a view to future 
enhancements, will also look for the files xd_fou.cif and xd_pro.cif (these are not 
currently produced by XD). In addition, a file xd_dat.cif is also sought. This last file is 
not produced by the XD programs, but must be supplied by the user. It should contain those 
details of the study which are not accessible in any of the other CIF's. Such information could 
include unit cell dimensions and errors, crystal size, crystal colour, space group symbols, data 
reduction details etc. A suitable file could be that from a SHELX refinement or a WinGX 
archive CIF, but of course with all the details of the refinement and structural geometry 
removed. 


XDCIF also needs to read a request file called xdcif.dat which must be placed in the 
directory pointed to by the environment variable XD_DATADIR (normally also the location of 
the XD databank files). If the environment variable XD_DATADIR is not set, the program will 
halt. This request file is user configurable and should include all the CIF data items which the 
user wishes to include in the final xd_archive.cif. Details of the syntax for these entries 
is given in the header to the default version of this file which is included in the XD release. 
Note that it is not important if a data item in this request list is not found in any CIF, but ifa 
data item is not present in the request list, then it cannot be included in 
xd_archive.cif. 


The program differs from other XD programs in being interactive. It will first ask the user if all 
the CIF's found in the working directory should be included in the output CIF. It then cycles 
through the items in the request list. If a data item is not found in any CIF, the user is given 
the opportunity of entering the data value manually. Alternatively, the user may respond 'a 
(for automatic mode), when the program will continue without further prompts. 


11.3.1 Files used and created by XDCIF 


Input: xd *.cif (* = fft, lsm, geo, dat, fou, pro) 
Output : xd archive.cif 
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11.4 XDWTAN - A Program to Analyse the Weighting Scheme 


XDWTAN analyses the structure factor file xd. fco written by XDLSM and provides a listing 
of discrepant reflections and tables of <uw(fo-F.)?> and R values as functions of hkl indices, 
index parities, F, and sin0/. It is based on the GX program WTANAL [138]. 


The reader should note that : 

e the XDLSM refinement may be based on either F or F? ( a user choice). 

e regardless of the choice, the xd. fco file always contains Fj2, F2 and o(F,?). 
e the weighting analysis is always based on Fy, Fe and o(F)). 


The calculated weights used in XDWTAN are based on these considerations, but may not 
necessarily exactly correspond with those used by XDLSM, due to approximations used in the 
program. 


The problems of choosing the correct weights for the observations in the least squares 
procedures are well known and of course not restricted to multipole refinements. See [139] for 
a discussion of this topic. The weighting scheme used by XDLSM is the same as that utilized 
in SHELXL [140] when refinement is based on F’, and the weight is based on this when 
refining against F (see Chapter 4}. Ideally the weights should be chosen such that <(A/o)?> is 
unity (A=Yo - Y), but this can rarely be achieved. This condition corresponds to «(w^2)» ~ 1, 
where w is the statistical weight equal to 1/6?(Y) and the so-called goodness of fit parameter 
(Gof or S) defined as 


Gof (S) = [Z w(Fo-F:)2 / (nobs - npar)]!/2 


in XDWTAN provides a measure of this. The Gof value is generally greater than unity and this 
may be due either to an inadequacy of the model or to an underestimation of the observational 
errors. In XDWTAN, for the listing of discrepant reflections with A/o(F) greater than 3.0, the 
overall Gof is used as an effective scale factor for the weights. Ideally there should be little 
variation of <(wA?)> with hkl indices, index parities, F, and sin0/A. The analysis is carried out 
firstly for all reflection data and secondly for only those reflections which were used in the 
least-squares refinement. 


11.4.1 Files used and created by XDWTAN 


Input: xd.fco, xd.mas 
Output : xd wta.out 
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11.5 AIM2TAB 


The program AIM2TAB is interfaced to XD, but is distributed separately. Please send an email 
to Dr. Anatoliy Volkov (volkov@chem. buffalo.edu) to request the program. 


AIM2TAB reads TOPOND9x, TOPXD or AIMPAC atomic integration files and calculates total 
molecular moments in original Cartesian coordinate system and Gaussian9x-like system 
using integrated atomic moments. AIM2TAB also prints out extensive information on other 
integrated properties, like atomic volumes, moments and integrated Lagrangians, etc. The 
program requires the file files.dat with | names and locations of 
TOPOND/TOPXD/ AIMPAC output files (1 line per filename). 


There are several optional input files: 


trans.dat to transform the coordinates (and atomic dipoles) of integrated atoms 
using rotation matrices and translation vectors in crystal coordinate 
system (1 line per atom): 
RII RI2 RIS R21 R22 R23 R31 R32 R33 TI T2 T3 


symm. dat to generate symmetry-equivalents of integrated atoms - 1 line per each 
new symmetry-equivalent atom in the following format: 
«atom label» R11 R12 R13 R21 R22 R23 R31 R32 R33 T1T2T3 
where <atom label> is the atomic label of the integrated 'parent' atom, 
and Rij and Ti are the rotations and translations in the crystal 
coordinate system, respectively. 


new.dat with additional information on atomic site occupations and number of 
electrons of the free atom (in the current version of AIM2TAB only 
atomic charges and volumes will be rescaled, NOT the higher moments). 
The format is (1 record per each atom): 
<atom label> <occupation> <n. of electrons in free atom> 


11.5.1 Files used and created by AIM2TAB 


Input: TOPOND/TOPXD/AIMPAC outputfiles, files.dat, 
(trans.dat, symm.dat, new.dat) 

Output : aim2tab.out 

11.4 LSDB 


This is a program for automatic setup of the atomic local coordinate systems and chemical 
constraints starting from a SHELX [140], PLATON [141] or XD structure files. The program is 
designed for interactive use and self-explanatory. The atomic local coordinate systems can 
then be visualized in PLATON. It is available upon request from Dr. Anatoliy Volkov 
(volkov@chem. buffalo.edu). 
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11.5 ADDGRID, SCALEGRID 


These are two simple interactive routines to add and scale grid files produced by other XD 
sections. In particular, ADDGRID allows summing, substracting, multiplying, dividing, scaling 
and applying exponents to a given number of grids. In this way, many properties derived 
(exactly or empirically) from the electron density and/or its derivatives can be visualized. 
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Chapter 12 


Example input files 


11.1 Parameter file (XD.INP/XD.RES) 


The new version of the parameter file has the following format: 


! <<< X D PARAMETER FILE >>> $Revision: 4.04 (Feb 26 2003)$ 23-Mar-03! 
Se eee ee ee eee eee ee eee eee eee eee ee eeeeeeeeeeeeeeeeerrrs 
XDPARFILE VERSION 2 

ICE8 MODEL 4 0 0 0 
LIMITS nat 2000 ntx 31 lmx 4 nzz 30 nto 0 nsc 20 ntb 20 nov 2500 
USAGE 2 0 4 2 0 1 0 1 2 8 19 0 10 1 


0.004206 0.004527 0.004206 0.004527 0.003877 20.003499 0.020006 0.656E-01 
-1.000000 0.000000 0.000000 0.000000 0.000000 0.000000 
0.000000 0.250000 0.193500 
0(1) 32 3 1 20 1 14 1 0 0.000000 0.250000 0.107100 0.2500 
0.050000 0.000000 0.000000 0.000000 0.000000 0.000000 
1.5653 0.0000 0.0000 0.0000 -0.0202 -0.0023 0.0000 0.0000 0.0213 0.0000 
-0.0077 0.0000 0.0000 -0.0148 0.0000 -0000 0.0000 -0.0032 0.0000 0.0000 
0.0000 0.0000 0.0000 0.0015 -0000 
1 0.000000 0.084300 0.193500 0.5000 
-000000 0.000000 


) 2 3 2 10 2 22 1 
0.050000 0.000000 0.000000 0.000000 

0.4347 0.0000 0.0588 0.0435 0.0000 -0.0195 0.0000 0.0000 0.0129 0.0378 
0.0000 0.0000 0.0000 0.0000 0.0000 -0000 0.0000 0.0000 0.0000 0.0000 
0 
1 
2 


OcOoOoooooo 


.0000 0.0000 0.0000 0.0000 0.0000 -0000 
0.981203 1.038973 1.038973 1.038973 1.038973 1.038973 
1.128085 1.434702 1.434702 1.434702 1.434702 1.434702 
0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 
0.0000E+00 
0.500000E+00 


The old format style is still accepted and interpreted, though the user must be aware that 
some default definitions have been changed (see Section 2.5 for example) and therefore 
parameters refined with older version of XD (and their corresponding xd.mas file) may no 
longer be consistent. 


142 


Chapter 12 - Example Input Files 


! <<< X D 9 4 >>> PARAMETER FILE 10-May-95 
PEPE P PPP Pe eee eee eee ee Pee ee eee ee eee ee eee ees 


OX MODEL 4 2 1 0 
50 31 4 16 01010500 724603023277321 
0.015316 0.022895 0.015316 0.022895 0.014542 0.028538 1.311589 0.287E+04 
0.000000 0.000000 0.000000 0.000000 0.000000 0.333300 
-0.480000 0.533500 0.097300 
0(1) 12 4 1 221141 0 0.085406 -0.055357 0.150364 1.000000 
0.006735 0.010111 0.003982 0.002321 0.001040 0.000480 
6.2230 0.0000 -0.0600 -0.0370 0.0000 0.0030 0.0000 0.0000 -0.0520 0.0420 
0.0000 -0.0280 -0.0200 0.0000 0.0000 0.0940 0.0000 0.0190 0.0000 0.0000 
0.0140 0.0190 0.0000 0.0000 0.0130 0.0230 
0(2) 12 4 2 121241 0 -0.221568 0.245041 0.036300 1.000000 
0.005866 0.009453 0.005785 0.002881 0.001785 0.000346 
6.1500 0.0000 -0.0750 -0.0050 0.0000 -0.0850 0.0000 0.0000 -0.0340 0.0290 
0.0000 -0.0080 -0.0090 0.0000 0.0000 0.0530 0.0000 -0.0010 0.0000 0.0000 
0.0250 -0.0100 0.0000 0.0000 0.0310 0.0110 
0(3) 1 3 9 3 7] 213 41 0 -0.451525 0.634807 0.178505 1.000000 
0.007195 0.010201 0.005492 0.001268 0.002323 0.000722 
6.3580 0.0000 -0.0460 -0.0020 0.0000 -0.0530 0.0000 0.0000 -0.0570 -0.0030 
0.0000 0.0690 0.0180 0.0000 0.0000 0.0030 0.0000 -0.0050 0.0000 0.0000 
-0.0030 0.0300 0.0000 0.0000 -0.0120 0.0030 
C(1) 12 2 4 122441 0 -0.044808 0.059521 0.052079 1.000000 
0.004960 0.006550 0.004314 0.000976 0.001389 0.000158 
4.2030 0.0000 0.0740 0.0060 0.0000 -0.2420 0.0000 0.0000 0.0920 -0.0280 
0.0000 -0.0010 -0.0320 0.0000 0.0000 0.3210 0.0000 0.0550 0.0000 0.0000 
0.0410 0.0080 0.0000 0.0000 -0.0390 -0.0300 
H(1) 3 1 1 4 223511 0 0.023390 0.021710 0.222800 1.000000 
0.013500 0.017540 0.010950 0.001830 0.003170 0.000050 
0.6500 0.0000 0.0000 0.0000 0.0420 0.0480 0.0000 0.0000 0.0000 0.0000 
0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 
0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 
H(2) 31 3 6 723611 0 -0.578320 0.696770 0.112691 1.000000 
0.014300 0.022450 0.012500 0.004000 0.000100 0.003200 
0.7090 0.0000 0.0000 0.0000 0.0830 0.0450 0.0000 0.0000 0.0000 0.0000 
0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 
0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 
H(3) 3: 3. y 623611 6 -0.358110 0.454570 0.149540 1.000000 
-016300 0.021300 0.018653 0.006210 0.007800 -0.001500 
-7090 0.0000 0.0000 0.0000 0.0830 0.0450 0.0000 0.0000 0.0000 0.0000 
-0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 
-0000 0.0000 0.0000 0.0000 0.0000 0.0000 


WWNrRRrFRrFODOO 


0.989779 0.850504 0.850504 0.850504 0.850504 0.850504 

0.989780 0.841628 0.841628 0.841628 0.841628 0.841628 

0.987340 0.888766 0.888766 0.888766 0.888766 0.888766 

0.980435 0.979516 0.979516 0.979516 0.979516 0.979516 

0.963906 1.000000 1.000000 1.000000 1.000000 1.000000 

1.043713 1.000000 1.000000 1.000000 1.000000 1.000000 
0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 
0.0000E+00 


0.869367E+02 0.911581E+02 0.375989E+02 


12.2 Master file 


This is the new format of the master file. The old format is no longer readable by XD (due to 
the changes in SCAT table). 
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! <<< X D MASTER FILE >>> $Revision: 4.04 (Feb 26 2003)$ 23-Mar-03! 
PEPE PPP ere 112223202 eee eee eee eee eee cere 0222 02272222 10322323123 31 2022 0201111102 132 0 0 
TITLE ice8 

CELL 4.6560 4.6560 6.7750 90.0000 90.0000 90.0000 

WAVE 0.7107 

LATT CI 

SYMM 0.25000-Y, 0.75000+X, 0.25000+2Z 

SYMM 0.50000-X, -Y, 0.50000+2Z 

SYMM 0.25000+Y, 0.25000-X, 0.75000+2Z 

SYMM X, -Y, -Z 

SYMM 0.25000+Y, 0.75000+X, 0.25000-Z 

SYMM 0.50000-X, Y, 0.50000-Z 

SYMM 0.25000-Y, 0.25000-X, 0.75000-Z 

BANK CR 


MODULE *XDLSM 
SELECT  *model 4 0 0 0 based on F test 
SELECT cycle 10 dampk 1. cmin 0.6 cmax 1. eigcut 1.d-09 
SAVE deriv lsqmat *cormat 


SCAT CORE SPHV DEFV 18 28 3S 4S 2P 3P 4P 3D 4D 4F 5S 5P 6S 6P 
(0) CHFW CHFW CSZD 2 -2 0 0 -4 0 0 0 0 0 0 0 0 0 
H CHFW CHFW CSZD -1 0 0 0 0 0 0 0 0 0 0 0 0 0 
END SCAT 


ATOM ATOMO AX1 ATOM1 ATOM2 AX2 R/L TP TBL KAP LMX SITESYM CHEMCON 
0(1) DUM1 Z O(1) H(1) Y R 0 1 1 4 mm2 

H(1) DUM1 X H(1) O(1) Y R 02 2 2 cyl 

DUM1 0.000000 0.250000 0.193500 

END ATOM 

a a ee SE EE E E E A Ee 
!GROUP2 atoml atom2 

KEEP kappa 1 2 

KEEP charge groupl 

WEIGHT -1. .0 .0 .0 .0 .0 

SKIP obs 0. 1.d10 *sigobs -1.d06 1.d06 *sinthl 0. 1. 

PRINT sinthl .0 2. obs 0. 15. delta 0. 10. del$ 80 100 extcn 80. 100. *abssc 
!EXTCN *iso aniso *type 1 type 2 type 3 distr g distr 1 *msc 0 msc 1 

!DMSDA 1.1 1.8 

FOUR fmodl 4 2 0 0 fmod2 -1 2 0 0 

ICON numl parl/iatl num2 par2/iat2 ... = num0 
|z2ln2ll22l022l21-5ll-2.2072.12.2l2. 7. E ESS 
KEY XYZ --U2-- ---- U3---- ------ U4------- M- -D- --Q-- ---O--- ----H---- 
O(1) 000 000000 0000000000 000000000000000 10 001 10010 1001000 100100010 
H(1) 000 000000 0000000000 000000000000000 10 110 10011 0000000 000000000 
KAPPA 110000 

KAPPA 110000 

EXTCN 0000000 

OVTHP 0 

SCALE 0 

END KEY 


5F DELF' 
0 0.0000 
0 0.0000 


DELF'' NSCTL 
0.0000 0.580 
0.0000 -0.374 
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END XDLSM 
PEPE P PPP Pee eee eee eee ee Pee ee eee eee ee eee ee ee eee ees 


MODULE XDFFT 
SELECT *fobs *fmodl fmod2 snlmin 0. snlmax 2. sig 3. phase 0. 
SELECT gridsize 0.2 scale 1. npeak 10 nhole 10 neutron gridf peakf 


END XDFFT 
PEPE P PPP Pee eee ee Pee eee Pee Pee eee eee eee ee eee ee eas 


MODULE XDFOUR 
SELECT *fobs *fmodl fmod2 print snlmin 0. snlmax 2. 
GRID *3-points perp cryst 


ATOM label ato(1) symm 1 trans 0 0 0 *mark on plot 
ATOM label ato(2) symm 1 trans 0 0 0 *mark on plot 
ATOM label ato(3) symm 1 trans 0 0 0 *mark on plot 
LIMITS xmin -2.0 xmax 2.0 nx 50 
LIMITS ymin -2.0 ymax 2.0 ny 50 
LIMITS zmin 0.0 zmax 0.0 nz 1 


END XDFOUR 
PEPE PP PP eee eee ee eee ee Pee ee eee eee eee eee ee eae 


MODULE XDPROP 
MODEL iam *multipole 
!APPLY symm 1 translations 0 0 0 ato(1) ato(2) 
SELECT *local numdx check esd nocore 
SELECT cpcut 0.0001 lmax 4 nstep 20 rcut 4.0 
SELECT scale 0.05 dx 0.001 ds 0.005 
SELECT radl 0.1 rad2 200. rad3 10. zonel 1 zone2 1 
!IGROUP ato(1) ato(2) 


!IDIPOLE *cmass center ucell 
!IQUADPOLE *cmass center ucell 
!D-POP 


PROPERTY  *rho gradrho d2rho nucpot elpot core valence defden sigrho siglap esp 
!QFIT grid 11 length 7.0 width 1.0 

!CONSTRAIN ato(1) ato(2) 

!STOKMOM defden lmin 0 lmax 4 *cmass center ucell debug 

!STOKMOM minlim -3. -3. -3. maxlim 3. 3. 3. epsa 1.0d-4 epsr 1.0d-4 
!STOKMOM atoms *all select ato(1) ato(2) 

IPOINT xy z 

!LINE ato(1) ato(2) npts 50 

!LINE points xl yl zl x2 y2 z2 npts 50 

!CUBE centre x yz 30 0.1 

!CUBE ato(1) ato(2) 20 0.1 

!MAP atoms ato(1) ato(2) ato(3) npts 50 stepsize 0.1 

IMAP bvectl x1 yl zl bvect2 x2 y2 z2 cen x0 yO z0 50 .1 

!CPSEARCH bond ato(1) ato(2) 

CPSEARCH bond rmin 1.2 rmax 1.6 

!CPSEARCH ring ato(1) ato(2) : 

!CPSEARCH shell ato(1) rmin 0.3 rmax 0.5 nrad 5 nang 11 11 cutoff 16.0 
!CPSEARCH BUBBLE ato(1) rmin 0.3 rmax 0.5 curv -3 ncps 3 

!CPSEARCH point x y z 

ICPSEARCH start file.cps 

!BPATH ato(1) ato(2) algrithm 2 


END XDPROP 
EEEELEEEEEZEREEEEEEZEEZEEREEEEEEEZZEZEEEBN EE ee eee eee eee ee eee eee EE EE P gg gg gn rtg 


MODULE XDGEOM 
SELECT rmin 0.8 rmax 1.8 tor *ato *bon *ang loc non 
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END XDGEOM 
PEPPP PPP Pee ee Pee eee ee Pee ee eee Ee eee ee ee eee ee eas 


MODULE TOPXD 
COMT just a comment for this run 
DEBG symeqv deriv *check 
CGEN alim -1. 2. blim -1. 2. clim -1. 2 
MPAR rcut 4.0d0 dstep 5.d-3 au iam 
!DGRD *use *gen fra gstep 0.2 0.2 0.2 read *ascii fort.69 
! 
!TRHO *seed all ail debug nstep 12 nnb 15 rmax 3.0 th 2.7 
! fra 0. 0. 0. 
! car 0. 0. 0. 
!TRHO *cluster all ail debug nstep 11 nnb 10 rmax 3.0 th 2.7 
!TRHO *pairs nr ail debug nstep 11 nnb 9 rmax 5. th 2.2 pc 0.3 
!TRHO *points nr ail debug nstep 20 nnb 9 rmax 5 fra 
! 0.0 0.0 0.0 
! 0.5 0.5 0.5 
!TRHO *line nr ail debug nstep 10 nnb 20 rmx 5. pc 0.3 
! point fra 0. 0. 0. 0.5 0.5 0.5 


! point car 0. 0. 0. 2. 2. 2. 

!TRHO *grid nr ail debug nstep 10 nnb 9 rmax 5 ncons 0 
! xmin 0. xmax 1. xstep 0.01 

! ymin 0. ymax 1. ystep 0.01 

! zmin 0. zmax 1. zstep 0.01 


!TRHO *profile perstep 2. 
! *atom ato(1) toneighbor 1 2 3 


! *point fra 0. 0. 0. l. 3. 

! *point car 0. 0. O. 25:24: 2% 

! 

ITLAP *auto ef CCCP ail debug nstep 15 nnb 10 rmax 3.0 ntheta 8 nphi 16 
! atoms ato(1) ato(2) ... nmax 0 rstar 0.d0 

! atoms ato(3) ato(4) ... nmax 2 rstar 0.d0 

! nna x 1. y 1. z 1. nmax 4 rstar 3.2 

! nna x2. y2. 22. nmax 4 rstar 3.2 

!TLAP *auto nr ail debug nstep 20 nnb 12 rmax 3.0 ntheta 16 nphi 8 

! atoms ato(1) ato(2) ... nmax 0 rstar 0.d0 


!TLAP *points nr ail debug nstep 23 nnb 11 rmax 4.0 nmax 14 

! car 1. 1l. 1l. 

! fra 0. 0. 0. 

!TLAP *line nr ail debug nstep 12 nnb 12 rmax 3.0 nmax 0 

! atom ato(1) toneighbor 1 2 3 

! points fra 0. 0. 0. 1. 1. 1. 

! points car 0. 0. 0. 2. 2. 2. 

! 

!ATBP Params PhInSph 48 ThInSp 32 *SavSurf 

!ATBP AltGuess BigStep 0.5 Accur 1.D-3 MaxRInt 10. Rmax 10. Step0 0.02A 0. BO. 

!ATBP Spheres ato(1) 0.2 ato(2) 0.2 ... 

!ATBP *atoms ato(1) iZFS nvi 100 IRsur 0 *IRSav Rest Debug Phi 32 Th 24 Rad 120 Accur 1.D-3 
!ATBP nna 0 

!x 0. y 0. z 0. *integ sphere 0.2 iZFS nvi 5 irsur -1 irsav rest debug phi 8 th 4 rad 120 ncp 0 
! 

!VZ3D *plot 

! files rays.dat 

! basins ato(1) ato(2) 
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! range *default xmi 0. ymi 0. zmi 0. xma 1. yma 1. zma 1. 
! grid *default dx 0.05 dy 0.05 dz 0.05 rvec *default 0.20 
!END VZ3D 

! 


!PL2D general 
! point car 0. 0. 0. 
atom 1 0-1 0 
atom 2 -1 0 -1 
plotdim xmin -2. xmax 2. xstep 0.5 ymin -2. ymax 2. ystep 0.5 
origin ishift 5 origin 0. 0. 0. vmod 0.5 
! misc size a4 scale 0.4 name 'test2d' title 
!PL2D *rhoo nstar 10 rmax 3.0 test cut 0.5 0 
!PL2D *lapp nstar 10 rmax 3.0 test cut 0.5 0. 
0 
0 


!IPL2D *lapm nstar 10 rmax 3.0 test cut 0.5 
!PL2D *grho nstar 10 rmax 3.0 test cut 0.5 
!PL2D *trajgrad nstar 10 rmax 5.0 test cut 0.5 0.2 0.5 0.5 *plane npath 36 nextr 0 

!IPL2D *molgraph nstar 10 rmax 5.0 test cut 0.5 0.2 toler 0.5 0.5 *plane thr 1.6 *trl *tr2 *tr3 

!PL2D *trajmolg nstar 10 rmax 5.0 test cut 0.5 0.2 0.5 0.5 *plane thr 1.6 *trl *tr2 *tr3 npath 36 nextr 0 
!PL3D general fra 

! xmin 0.0 xmax 0.5 xstep 0.05 

! ymin 0.0 ymax 0.5 ystep 0.05 

! zmin 0.0 zmax 0.5 zstep 0.05 

! name 'test3d' 

!PL3D *plot rhoo lapp grho 

!P2DCRY *diff rhoo filel file2 

!P2DCRY *diff lapm file3 file4 

!P2DCRY diff test2d rhoo 

!P2DCRY diff test2d trajmolg 


END TOPXD 
PEEP P PP Pee eee ee Pee eee ee eee eee eee eee eee eee ee eee eas 
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Chapter 13 
XD Installation 


13.1 What you need ... 


First of all, you need the XD package itself. This is currently available as source code for some 
operating systems, but it is tested and developped only for Linux. 


You need a FORTRAN-77 compiler which knows about some common language extensions like 
INCLUDE or DO ...ENDDO to compile most of the programs. The graphics program and the 
master control program are written in C, so you need an ANSI C compiler, as well. Note that 
some C compilers provided as part of the operating system are not ANSI compatible. 


To be able to run the plotting program XDGRAPH you need the Tcl and Tk libraries and 
optionally some OpenGL library. The program is tested with Tcl version 7.3 and Tk version 


3.6p1 and upwards. 


Currently, the following parts of XD are available: 


xd The complete package. These are just all files of the parts listed below packed 
together. If you have this, you don't need to retrieve any of the parts below. 

master The master control program (xd), and some utility programs (xdini, xdlspar), the 
databank files and the makefiles used to install the complete package. 

libxd The library used by all other programs. 

xdlsm The least-square program. 

xdfour The Fourier program. 

xdfft The Fast Fourier program 


xdprop The property program. 
xdgraph The graphics program. 
xdgeom The program for analysing the geometries 
topxd The program for a full topological analysis 


13.2 Installing XD on VMS systems (no longer supported) 
13.2.1 Tcl and Tk from source 


There is no need to read this section, if Tcl and Tk are already installed on your system. If you 
just have to install Tcl, but can’t make use of Tk, just ignore any references to that package. 
You can get versions of Tcl and Tk modified to work under VMS by anonymous ftp from 
mango.rsmas.miami.edu: /pub/VMS-tcl or 

src.honeywell.com: /pub/vms-tcl. 

These are the original ports created by Angel Li. You can also find a slightly modified version 
on ftp.fu-berlin.de. Basically, some unnecessary files are removed and command files to 
compile and install the packages are provided. The tk-photo extension is removed as well. 
Here is how to install this distribution. 


First of all, you have to pick a directory where to unpack and compile the source code. Space 
requirements in blocks: 


148 


Chapter 13 XD Installation 


zip archive unpacked source after compilation installed 
tcl 800 3000 4000 800 
tk 1400 4500 8500 2000 


Unpack both archives in the same directory. This will create sub-directories [.TCL73] and 
[.TK36]. Change into these directories and edit the file MAKE.COM. You have to change the 
five symbols at the top: 


tcl library | tk library The directory, where the necessary Tcl scripts will be stored after 
installation. This has to be given in a unix-like notation. You can change 
the value at run-time by defining the logical TCL LIBRARY or 


(TK LIBRARY) 

tcldir | tkdir This is the same directory as tcllibrary (tk library), but in VMS 
notation. You have to specify this directory in both forms. 

bindir Where the executables will be stored. 

libdir Where the object libraries will be stored. 

incdir Where to put the include files. 

Execute 

$ make 


And if everything is ok 
$ make install 

You might want to do 
$ make test 

in between. 


13.2.2 XD from sources 


Choose a directory where you want to install the sources, e.g. [SOURCES.XD]. Most parts of 
XD are installed in separate subdirectories that are created while unpacking the archives, but 
you have to create the top level directory which must hold all subdirectories. 


Unpack the archive in the top level directory. Edit CONFIG.COM (see further notes in this 
file). 


Rename fortran source code to from .f to .FOR by executing 
$ @tovms 

Compile and link the various programs 

$ @make 


Copy the necessary files into their destination directories 
$ @make install 


Finally, edit setup.com, which defines the foreign commands needed to start the programs. 
You won't be able to specify compound-id or model-id by starting the programs with a $ RUN 
command. 


13.3 Installing XD on Unix systems 


13.3.1 Tcl and Tk from source 


There is no need to read this section, if Tcl and Tk are already installed on your system. If you 
just have to install Tcl, but can't make use of Tk, just ignore any references to that package. 
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Get Tcl and Tk from an ftp server next to you. Follow the instructions that come with those 
distributions. 


13.3.2 XD from sources 


Choose a directory where you want to install the sources, e.g. /software/sources/xd, lets call 
it TOP. Most parts of XD are installed in separate subdirectories that are created while 
unpacking the archives, but you have to create the top level directory which must hold all 
subdirectories. To configure XD for your particular needs, copy $TOP/mk.config.dist to 
$TOP/mk.config and edit this file. The file contains further details what to do. The most 


important part consists of specifications where XD should finally be installed. 


XD_LIBDIR Where to put the object libraries, for example: 
/usr/local/lib. 
XD_BINDIR Where to put the executables, for example 
/usr/local/bin. 
XD_TCLDIR Where to put the tcl/tk scripts coming with xdgraph. This should be a 


directory on its own, for example: 
/usr/local/lib/xd/ tcl. 

XD DATADIR Where to put some datafiles (including the databanks). For example 
/ usr/local/lib/xd. 


Finally, in directory $TOP you say 

make arch 

where arch is one of irix, aix, osf1, hpux. If you want to compile for another architecture use 
unix and edit the appropriate files in $TOP/ports. Compilation will be done in architecture- 
dependant separate subdirectories of each part of the package. E.g. object files for the least 
sqares program, compiled on a SGI Indigo running Irix will be created in 
$TOP/xdlsm/src/obj.irix. 


After compilation you 
make install 
and all files will be copied to the directories given in mk.config. 


Some parts of the XD code (for example XDCIF) additionally require that XD DATADIR be 
defined as environment variable. It is also suggested to define XD BINDIR as environment 
variable, in order to have access to all executables, without requiring a script file. 


13.4 Installing XD for Windows 


The MS Windows version of XD is available from the website 

http:/ /www.chem.gla.ac.uk/ -louis/software/xd 

It is supplied as a password-protected standard Windows installation program. This includes 
all executables (with all required run-time libraries) and all system files. It is strongly 
suggested to install into the default directory given by the installation program. In addition, 
the working directory containing the XD data files (xd.mas, xd.inp etc) should not 
contain an embedded blank in its name, or all programs may not work. 


In order to function, the following environment variables need to be set 


XD DATADIR (points to directory containing the data bank files) 
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XD TCLDIR (points to directory containing the XDGRAPH Tcl scripts) 
TCL LIBRARY (points to directory containing the TCL 8.3 system scripts) 


Example values for these variables would be 


XD DATADIR- «xddir?/ lib/ xd 
XD TCLDIR- «xddir?/ lib/ xàgraph 
'TCL LIBRARY- «xddir»NbinNtcl8.3N 


where «xddir» is the fullpath of the XD installation directory, e.g. c:/xd or c:\xd. Note the 
use of Unix style forward slashes '/' rather than DOS backslashes '\' as delimiters for the 
directory names with XD DATADIR & XD TCLDIR. These are a result of porting a Unix 
program to Windows and appear to be necessary. The standard DOS backslash should be use 
for TCL LIBRARY. 
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